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Preface 



This manual will help you to modify an existing HP driver or to write a new driver for an I/O card 
or device. 

To best use this manual, you should know HP assembly language, HP 1000 computers, and should 
be able to make effective use of the RTE-A I/O Control Technical Specifications and system 
listings. You may not need these documents, but if the driver is complex, a thorough knowledge of 
the operating system (as it applies to I/O) may be needed to debug the driver. 

To make this document as self-contained as possible, it contains some information that may also 
be found elsewhere. For example, the section on I/O Card Programming duplicates some 
information found in the A-Series I/O Interfacing Guide. 
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Introduction 



A program is allowed to do I/O (input/output) transfers only under the supervision of the 
operating system. While a user program is executing, the memory protect feature is on. This 
feature serves the dual function of protecting the operating system from inadvertent destruction by 
a user program and also insures that the operating system itself controls all I/O transfers. Any 
program that attempts an I/O instruction while the memory protect feature is on will cause an 
interrupt, suspending the program and transferring control to the system. The system then aborts 
the offending program. 

All I/O requests are made to the system through EXEC calls, which are requests to the operating 
system. When a program which makes an EXEC request is loaded, the JSB EXEC instruction is 
replaced by an unimplemented instruction. The unimplemented instruction is trapped by the 
system and tested against an instruction chosen to represent the EXEC request. If it passes the 
test, and if the parameters in the request are valid, the request is processed. Otherwise, the 
program may be aborted. (It is possible to specify "no abort" in some cases.) 

I/O requests are sorted out (through the request code) and processed by the operating system 
modules called RTIOA and IOMOD. These two modules work together, and are referred to 
jointly as RTIOA. One of the several functions of RTIOA is to relate the logical unit referenced 
by the user request to a physical device, which it does through the LUT (Logical Unit Table). The 
user request is then put into the form of a table called the I/O control block. 

The information set up in the control block is processed for the I/O operation by operating system 
modules called drivers. Drivers may be divided into two modules; a module that deals with the 
device and a module that deals with the I/O card. Together they perform the single function of 
implementing the I/O request made by the user program and formatted by the system. 

Prior to entering the driver, the system takes the information from the control block and puts it 
into another table, called the driver's DVT (Device Table). The request in the DVT is processed 
by the driver to perform the desired action (input, output or control). All information pertaining 
to the operation of a specific request is maintained in the DVT, which therefore becomes the 
primary directing force of driver operations. 

Data is usually transferred under DMA (direct memory access). With DMA, an entire buffer is 
transmitted before the computer receives an interrupt signifying completion. Alternately, a driver 
may set up a card to create an interrupt per word/byte. In either case, once the transfer is set up, 
it proceeds on an interrupt basis. When the device is not ready to make an actual transfer, other 
processing takes place. When an interrupt occurs, the driver is entered (under system control) to 
take the proper action. 

When a user request is received by the system, it may not be possible to initiate the operation 
immediately, since another request may be in progress. In this case the I/O control block is linked 
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to previous blocks in a list. The list itself is linked to the DVT of the driver. When the driver is 
finished processing one request, the system sets it up for the next request. 

I/O requests are generally linked to the driver in order of the priority of the program making the 
request. 



User I/O Requests 



The several requests associated with I/O are given below. Not all of these requests reach the 
driver. Those requests that are processed by the driver are indicated. 



Function 


Request 


Code Seen by the Driver 


READ 


1 


1 


WRITE 


2 


2 


CONTROL 


3 


3 


STATUS 


13 


NONE 


CLASS READ 


17 


1 (READ) 


CLASS WRITE 


18 


2 (WRITE) 


CLASS CONTROL 


19 


3 (CONTROL) 


CLASS WRITE/READ 


20 


1 (READ) 


CLASS GET 


21 


NONE 


LU LOCK 


NONE 


NONE CALL LURQ ( ) 


CLEAR CLASS 


NONE 


NONE CALL CLRQ ( ) 


L88-323 







Figure 1-1. User I/O Requests 



The driver processes only three basic requests: 

1. Input 

2. Output 

3. Control 

Consistent with this philosophy, class I/O requests also reduce to the basic three. The driver does 
have a means of identifying a class request through certain bits recorded in the DVT, but this is not 
normally a driver concern. 

There are two types of status requests. The "static" status request (request code 13) does not 
cause the driver to be entered and so the actual device is not accessed. The status is that taken 
from the DVT and represents the status upon last I/O completion. The "dynamic" status is 
implemented through a control request (request code 3, subfunction 6) and thus causes the driver 
to be entered. The driver must recognize a subfunction code which differentiates the dynamic 
status request from other control requests. 
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Device-Interface Separation 



A driver may be broken down into two parts (the device driver and the interface driver) or remain 
as a single driver (the interface driver). A device driver is not required, or useful, if the interface 
card is used to control a single device or identical devices. The device driver proves most useful 
when there are several possible device types cabled to the same interface type, for example, the 
HP-IB. 

The device driver, when present, formats the output buffers or interprets the incoming buffers 
according to the characteristics of the device. If the device driver is absent, as in minimum-sized 
systems, then the individual programs must perform the interpretation functions that would 
normally be done by the device driver. 

The interface driver may perform some functions other than I/O, although they should not be 
device-specific. For example, it may append an EOR (end-of-record) character to output or it may 
translate all characters into a specific code (such as binary-coded decimal). It may recognize 
special characters and manipulate the data accordingly or it may transmit all characters 
unchanged. 

One advantage of this approach is that the characteristics of the device may be changed by 
accessing the device driver only. For example, the number of lines/page on a line printer could be 
changed by a control request with a subfunction defining the number of lines. This could be done 
even if the interface card was busy with another device at the time. 

Another advantage is the ease by which new devices may be connected to the I/O cards. Using an 
existing interface driver, one need only write the device driver to handle the characteristics of that 
new device. 

Even though there are some advantages to separating the characteristics of the device and the 
interface and breaking the driver into two parts, this separation is not always recommended. For 
specialized I/O interface situations, it may be preferable that a single interface driver be designed 
to handle both the device and the interface. 
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I/O Request Interaction 

Figure 1-2 (below) is a simplified representation of how the user request interacts with the drivers. 



Device 
Initiate 



User Request 



Device 
Timeout 



Device Driver 



Interface 
Initiate 



Interface, 
Timeout 



Device 
Done 



Device Wait 



Interface 
Done 



Interface Driver 



Interface 
Wait 



Device 
Resume 



Interface Card 



Interface 
Continue 



Figure 1-2. I/O Request Interaction 

These interactions are described in more detail below. Although the diagram shows several 
reasons for entering a driver, the driver is always entered at the same place, whatever the reason. 
The reason for entering the driver is contained in a code in the A register. This code is the entry 
"directive." Exit from the the driver is to a different return point, according to the type of exit. 

DEVICE INITIATE (DI): This is the starting point for processing all EXEC and XSIO calls, 
assuming that a device driver exists. 

DEVICE DONE (DD): This exit completes the active request. 

DEVICE RESUME (DR) calls the device driver to finish processing an asynchronous interrupt 
detected by the interface driver. 

DEVICE WAIT (DW): This exit permits the device driver to await the completion of some timed 
action. It may also be used to indicate completion of asynchronous processing begun through a 
resume entrance. 

DEVICE TIMEOUT (DTO): A request on the device has timed out (perhaps a failure). The 
device driver may use timeouts for the purpose of issuing periodic requests to the interface driver. 
For example, to check the status of a communications line. 
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INTERFACE INITIATE (II): This entry indicates the start of a request on the I/O card. 

INTERFACE DONE (ID): This exit indicates the completion of a request started on the I/O 
card. 

INTERFACE CONTINUE (IC): This is the continuation entry into the driver caused by an 
interrupt. This includes asynchronous interrupts. For example, an SRQ interrupt on the HPIB is 
an asynchronous interrupt. 

INTERFACE WAIT (IW): The driver takes this exit to wait for an interrupt or timeout. 

INTERFACE TIME OUT (ITO): This entry indicates an expected interrupt was not received in 
the allotted time. 

"Asynchronous interrupt," as used in this manual, means an interrupt that occurs when the I/O 
card is not busy with a user or system I/O request. The I/O card is usually idle, and has been 
armed to recognize asynchronous interrupts, such as are generated when a user strikes a terminal 
key when no read is pending on the I/O card. An "expected interrupt," on the other hand, is one 
which signals the completion (or continuation) of a request from the system or a program. 

When the system enters a driver, I/O interrupts are in a "hold-off" state. They are enabled only 
for the time base generator (TBG) and privileged drivers in the system. Since an entry to a 
non-privileged driver is always controlled by the system, a driver may call upon subroutines within 
the operating system. Several subroutines are supplied to make certain tasks easier for the driver 
and to avoid the duplication of functions from driver to driver. 

There is no direct path between the device driver and the interface driver. For example, the 
device driver never directly calls the interface driver. Both modules are entered only by the 
system and each module returns to the system. Communication between the device driver and the 
interface driver may take place through a parameter area located in the DVT for that device. 

A DVT always exists even though a device driver is not required. The request is always formatted 
in the DVT and status information passed back in the DVT, whether or not a device driver exists. 

When a request is made by the user or the system, it is formatted into a table called the I/O 
control block and linked to the DVT. Several requests may already be in the linked list — the 
newest request is added on. When a request reaches the head of the initiation list, the system 
takes the information out of the control block and places it into the DVT. The normal flow is then 
as follows: 

1. The device driver decodes the request which has been placed in its DVT and formats a 
request for the interface driver and stores it in the DVT. Upon exit, the device driver notifies 
the system that this is an "interface initiate" exit. 

The system takes the device drivers request and links it to the interface driver through the 
DVT. 

2. When the request reaches the list head, the system enters the interface driver with a signal to 
begin the new request. The interface driver has a table called the IFT (InterFace Table) 
which links it to the driver's DVT The interface driver picks up the request from the DVT 
and initiates an actual I/O sequence to the interface card. It then takes a "wait" exit to the 
system. 
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3. When an interrupt occurs, it is trapped by the system. The system enters the interface driver 
with a "continue" directive. Normally, the interrupt signifies the completion of a block 
transfer under DMA. In this case, the interface driver would post status information in the 
DVT and take a "done" exit. 

4. The system then enters the device driver with a "continue" directive. The device driver may 
interpret the information received from the interface driver and reformat it for the device. It 
then indicates a "done" status and returns to the system. 

5. If another control block is linked up to the DVT, its data is moved to the DVT and the device 
driver is entered for the next request. 

Many complexities can arise in the above sequence. For example, a device driver may break a 
single user request into several requests upon the interface driver. Assume that the request is a 
disk read operation. This may be broken into at least two parts; a seek and then the actual read 
when the head reaches the proper cylinder. After the seek operation, the interface driver would 
be "done." But the device driver would not be done with the user request and hence would format 
another request to the interface driver. 

The interface driver has no knowledge that it is doing a read operation or even that it is 
communicating with a disk drive. It is merely passing information back and forth. The only errors 
it handles are those dealing strictly with the interface card. 

The device driver, on the other hand, knows that it is communicating to a disk and what control 
words or buffers are required for each request. It also knows to make certain checks on the 
parameters that are specific to the device. For example, it may check that a disk sector number is 
valid. 

The "resume" exit from the interface driver and the "resume" entry into the device driver are used 
together, similar to interface done and device continue. The resume is used when the interface 
driver has received an asynchronous interrupt which requires interpretation. Generally, this 
means that an interrupt has occurred from a device that was previously armed to recognize 
asynchronous interrupts. This may happen, for example, when a user strikes a key at a terminal to 
gain attention. 
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Driver Names and Module Type 



The driver name is the symbol that is given in the NAM record in the source code. For example, 
ID.00 in the following: 

MACRO, L 

NAM ID. 0 0,0 

The module type is 0 (zero) and is the parameter which follows the comma in the NAM record. 
Module type 0 identifies the driver as part of the operating system itself. 

The convention for naming device and interface drivers is: 

DDxnn is for Device Drivers 
IDxyy is for Interface Drivers 

x represents the Originator Code. 

nn is the Device Driver Type, a number. 

yy is the Interface Driver Type, a number. 

When choosing the originator code, note that the period (.) and asterisk (*) and letters of the 
alphabet are reserved for drivers which originate from Hewlett-Packard. Customers may use any 
of the following special symbols: 

! " # $ % A _ ? 
For example, DD$12 or ID!37. Other symbols are not legal in filenames. 

The convention HP uses to refer to driver names has been changed from DD.nn to DD*nn. The 
HP driver relocatable filenames of the form %DD.nn have also been changed from %DD.nn to 
%DD*nn. HP driver names in the NAM statement (DD.nn) and driver entry points (DD.nn) 
remain the same. 

DD*nn Referenced driver name 

%DD*nn Driver relocatable name 

DD.nn Driver name in NAM statement 

DD.nn Driver entry point 
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Driver Type Codes 



Device Driver 

Device driver type codes are arranged by functional groupings as below. The type code is placed 
in DVT6 by the generator. The default by the generator is the field "nn" in the driver's entry point 
(as in DD.nn) but the type code can be changed at generation time. A user program may examine 
device type to determine what requests to issue. A multi-device driver can examine device type to 
determine what specific device to operate. 



Category 


Type 




Device to be Driven 


TCpvhnarrl "FiiriptinTw 
lYvyuuaiu J. liiivijajho 

00-07 octal 


00-05 
07 


Tntpfjiptivp "nnint-to-nnint tprminalQ 

All Ll^l CIV 11 V ^ L/U111L LkJ LJVJ111L LV1 111111C113 

Multipoint data link 


Svstpm Pprinhprals 

10-17 octal 


10B- 
12B- 
14B- 


11B 
13B 
17B 


Plottprs pranhips Hisnlav 

Printers 

(reserved) 


^ptijiI rprnrHino "Dpvipp^ 

20-27 octal 


20B- 
25B 
26B 
27B 


■24B 


lVTao tanp pa^pttp 

IVldii lupL, taoot LLC- 

(reserved) 
CS/80 tape 
(reserved) 


Random Recording 

Devices 

30-36 octal 


30B 
32B 
33B 
36B 




Floppy disk 
CD disk 
CS/80 disk 
PROM 


HP-IB (37 octal) 


37B 




HP-IB interface bus 


CPU Functions and 
Misc. Peripherals 
40-47 octal 


40B- 
44B- 


43B 
■47B 


PROM I/O, WCS, powerfail, etc. 
Badge reader, strip printers, 
light pen, etc. 


Digital/Analog 
50-57 octal 


50B- 
54B- 


53B 
57B 


Parallel interface card, etc. 
A/D, D/A 


Data Communications 
60-67 octal 


60B- 
63B- 
65B- 


62B 
64B 
67B 


Data comm., MUX, etc. 

(reserved) 

DS network, etc. 


Instrument and Test 
70-77 octal 


70B- 
76B- 


75B 
•77B 


Instruments 
Diagnostics 
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Interface Driver 

The interface type for driver with entry point ID.yy defaults to "yy" and may be changed at 
generation time. Interface types are defined as follows: 



00- 


-07 


Communication (hardwire or remote) interface cards, RS232 


10- 


-17B 


Digital I/O cards 


20- 


-27B 


Dedicated peripheral controller 


30- 


-37B 


General purpose I/O card, for example, HP-IB 


40- 


-47B 


Special processor functions. ID.43 reserved for power fail 


50- 


-57B 


Digital/Analog I/O 


60- 


-67B 


Network Communications 


70- 


-77B 


Instrument Controllers 



Driver Entry Points 

Entry points must agree with the name of the driver. Except for privileged drivers, the entry point 
should be the same as the driver name itself. For example: 

MACRO, L 

NAM ID. 0 0,0 
ENT ID. 0 0 



Privileged drivers have two entry points. For normal system entries, the entry point should be the 
same as for a standard driver. For privileged interrupt entry, use: 

PI . XX 

For example: 

MACRO, R,L * THIS IS THE START OF A PRIVILEGED DRIVER * 
NAM ID. 51 
ENT ID. 51, PI. 51 
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GEN Pseudo Instruction 



The assembler provides the capability of passing instructions from the source code to the 
generator. This is done with the GEN pseudo instructions, called "pseudo" because they do not 
produce actual CPU instructions. 

For example: 

GEN 10,EID.37,QU:PR,TX:124 

which specifies that the driver has entry point ID.37, priority queuing of requests and an extension 
area of 124 words. The number after the GEN instruction (in this case 10) indicates the number 
of words (2 characters/word) in the following string. The last character will be set to a space 
character if not specified. 

With the exception of the "E" shown in the entry point name, all instructions in the GEN record 
are exactly the same format as would be given in the answer file to the generator. For example, 

GEN 10,DP:2:FM:GR:20 04 0B:0 

which sets driver parameters 2, 3, 4 and 5 to FM, GR, <two spaces >, and 0. 

The GEN instructions provide default parameters for the driver and make it easier to prepare the 
answer file. Any parameters given in the answer file will override similar commands given in the 
GEN instructions. For example, a different extension area size could be specified. 

Any number of GEN instructions can appear in the driver. 
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System I/O Tables 



The system I/O tables provide an area of memory for storing and passing information about the 
I/O structure and I/O activity. These tables reside in and are maintained by the operating system. 
A summary of these tables is given below: 



LUT Logical Unit Table 

DVT Device Table 

IFT Interface Table 

INTA Interrupt Table 

MST Map Set Table 



Relates logical units to device tables. 

Maintains information about the I/O request and 
the physical device. 

Maintains information for an interface card. 

Relates interrupts from interface cards to 
interface tables. 

Maintains information for correlating map sets to 
select codes. 



Each of the tables above is built by the system generator. In some cases, as in the DVT and IFT, 
only part of the table is initialized by the generator. The contents of each table and how they are 
used will be discussed in this chapter. 

There is a DVT entry for every device and an IFT entry for every interface card recognized by the 
system. 

Normally, the only I/O tables referenced by the driver are the IFT and the DVT. 
Figure 2-1 shows the interaction between the LUT, the DVTs and the IFTs. 
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CALL EXEC 



LU 
T 






F 

DVT 

Active Req 




DVT 

Active Req 




DVT 

Active Req 



























Device 
Driver 



Device 
Driver 



Device 
Driver 



I FT 



Interface 
Driver 
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I/O Card 



Figure 2-1. Request Lists on DVT and IFT 

(There may be several IFTs in the system but only one is shown for clarity.) 
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Logical Unit Table LUT 

The Logical Unit Table (LUT) is a variable length table built by the system generator. The LUT 
relates the logical unit (LU) in the user request (EXEC call) to the DVT Its format is: 





<address 


of 


some 


DVT> 




<address 


of 


some 


DVT> 




<address 


of 


some 


DVT> 




<address 


of 


some 


DVT> 


L88-326 











Figure 2-2. Format of the Logical Unit Table 



The logical unit is used as an index into the table. For example, for arbitrary logical unit LU X: 

Pointer = (X - 1) + address of LUT 
DVT address = contents of pointer 

A pointer to the LUT and the number of entries in the LUT are globals located in RTIOA (see 
section on Table Pointers). The size of the LUT and its entries are set up by the system generator. 
The entries are modifiable on-line with an operator command and thus their direct use by any 
driver should be avoided, where possible. 

More than one LU can point to the same DVT. An LU can also be assigned to zero (the bit 
bucket), in which case the corresponding entry in the LUT is zero. 



Device Table DVT 

The device table (DVT) is a variable-length table constructed by the system generator for each 
device in the system. It is the area from which the system communicates to the device driver 
information about the request. The system uses the DVT as a storage area for list link words, 
DVT status indicators and other system concerns. The device driver uses it for device dependent 
storage and a communication area to the interface driver. The interface driver may store device 
status in the DVT upon completion of a request. 

Every device to be accessed by an LU must have a DVT. If no device driver exists, it is the 
responsibility of the interface driver to retrieve and post information in the DVT. 

The format of the DVT is given in Figure 2-3. 
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DVT1 

DVT2 

DVT3 

DVT4 

DVT5 

DVT6 

DVT7 

DVT8 

DVT9 

DVT10 

DVT11 

DVT12 

DVT13 

DVT14 

DVT15 

DVT16 

DVT17 

DVT18 

DVT19 

DVT20 

DVT21 

DVT22 

DVT23 

DVT24 

DVT25 

DVP1 

DVX1 



System 
Pointer 
Name 

$DV1 

$DV2 

$DV3 

$DV4 

$DV5 

$DV6 

$DV7 

$DV8 

$DV9 

$DV10 

$DV11 

$DV12 

$DV13 

$DV14 

$DV15 

$DV16 

$DV17 

$DV18 

$DV19 

$DV20 

$DV21 

$DV22 

$DV23 

$DV24 

$DV25 

$DVP 
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15 14 13 12 11 10 



DVT Link Word 



Q 



N 



X 



Request Initiation List 



Circular Node List 



Circular DVT List 



Address of Interface Table 



AV 



Device Type 



System Flags 



B 



Status 



LU Lock Flag (Res #) 



RS 



Buffer Limit Accumulator 



(High-Low)/16 



RESERVED 



Low Buff Limit/16 



Starting Physical Page 



Timeout List Linkage 



Device Driver Timeout Clock 



Interface Driver Timeout Value 



Device Driver Entry Address 



TY 



UE Z 



Subfunction 



L BB 



RQ 



Request Parameter #1 / Error code with D,F 



Request Parameter #2 / Transmission Log 



Request Parameter #3 / Extended Status #1 



Request Parameter #4 / Extended Status #2 



I 



Driver Communication 



# Driver Parameters 



Device Priority 



# Extension Words 



DVT Extension Address 



Starting Physical Page of Driver 



M 



Reserved 



Spool Node List Pointer 



Start of Driver Parameter Area 



Start of DVT Extension Area (Storage) 



Figure 2-3. Format of the Device Table 

DVT1 is the DVT link word, used by the system to put the DVT into various lists. For example, 
device driver requests passed to the interface driver (initiate exit) are linked via this word to word 
3 of the IFT. It is set to - 1 if not linked into any list. 

DVT2 is the request initiation list. I/O control blocks built by the system as a result of a user 
request are linked to this word. It may be examined by a driver (device or interface) to determine 
if a request is currently in progress. Its contents will be 0 if no requests are pending. 

The Q bit is set to 0 by the generator as a default to indicate that the request list is ordered by 
priority. The driver may change Q to 1 to indicate a FIFO list is desired (first in, first out) via 
a GEN instruction. 
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DVT3 is the circular node list. This word links all DVTs which share a common node. A node 
connects all devices which cannot operate concurrently. An example is the keyboard/display and 
the mini-cassette drives on a 26XX terminal. Access to any of these features of the terminal 
excludes access to other features on that node at the same time. This list is set up by the 
generator. 

If a device on a node is busy, then the node itself is busy and no other devices on the node can 
be accessed. New requests are held off until the node is free. The N bit indicates the activity 
on the node. N=0 indicates node available; N=l means the node is busy. The system sets 
this bit to 1 when it initiates a new request and it should not be changed by the driver. 

When initiating a new request, the system checks the N bits on all the DVTs in the circular 
node list. One busy bit (there should not be more than 1) is sufficient to hold of the request 
until the node is not busy. 

Devices in the node list share a common DVT extension, which is as large as the largest 
extension needed by any of the devices. The driver parameter area is not shared, but remains 
unique to each device. 

If there is only a single DVT on the node, this word points to itself. Otherwise, it points to 
word 3 of the next DVT. 

DVT4 is the circular DVT list. This word links all DVT's that point to the same IFT, that is, it 
connects all device drivers with a common interface driver. It may be used by both the device 
drivers and the interface drivers. See the section on asynchronous I/O and polling in Chapter 6 for 
more information. 

If there is only one DVT connected to the IFT (no circular list), then this word points to itself. 
Otherwise, it points to word 1 of the next DVT. 

The P bit is for power fail. If the device driver wishes to handle power fail, it should set the P 
bit to 1. The generator defaults this bit to 0. 

DVT5 is the IFT address. This is the address of the associated IFT. Bit 15 is reserved for future 
use and should not be changed by a driver. 

DVT6 is Availability/Device Type/Status: 



AV 


DEVICE TYPE 


STATUS 


E 
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AV is availability. This is the current status of the DVT and is used by the system for I/O 
control. It may be examined by an operator command or by a driver to determine if a request 
is in progress. 

AV Meaning 

00 The DVT is available for a new request to be initiated. 

01 The associated device is "down." New requests will be I/O suspended. 

10 The DVT is busy with a request. New requests may be pending, linked through DVT2. 

11 The DVT is both down and busy. 
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DEVICE TYPE is a two-digit octal value used to describe the type of device associated with 
the DVT. The type is entered as a generator input or defaults to the driver number (see the 
section on Naming & Type Conventions). 

A driver may use the type code to make decisions on what action to take in otherwise 
ambiguous situations. 

In the absence of a device driver, the generator will default the device type to 70B. 

STATUS is a general device status word reflecting the state of the device as posted by the 
driver upon last access. The bits have defined meaning as follows and should be so used by 
the driver: 



7 


6 


5 


4 


3 


2 


1 


0 


EOF 


DB 


EOM 


BOM 


SE 


DF 


DF 


E 






Set by driver, as needed 






Set by 
System 
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EOF is End Of File. Used for mini-cassette tapes, magnetic tapes, card readers, etc. 
EOF = 1 when condition is true. 

DB is Device Busy. Indicates that the device is performing a function which prevents 
other operations from starting, for example, mag tape rewind. DB = 1 when condition is 
true. 

EOM is End Of Medium. Set when the current request has positioned (or will position) 
the physical medium past the maximum limit. For example, write 2 disk tracks when 
only 1 track remains to be used. 

BOM is Beginning of Medium. When set, indicates that the medium is at the start of the 
recording area. 

SE is Soft Error. An error occurred which caused the driver to attempt an error 
recovery operation. The E bit may or may not be set, depending upon whether or not 
the operation was eventually successful. 

DF is Driver Definable. 

E is an Error indicator set by system if the driver sets any error code in DVT16. Drivers 
should not change this bit. 

DVT7 is System Flags/LU Lock Flag/Request Status: 



SYSTEM FLAGS 


LU LOCK FLAG (ID #) 


A 


RS 
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SYSTEM FLAGS are reserved for use by the operating system. These bits are updated by the 
system on each exit from the driver. The system flag bits are copied from bits 4 through 0 of 
the A register, which must be set by the driver prior to exit. 
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The meaning of these bits is given here in brief. They are covered more completely in 
the section on System-Driver Interface: 



Type of 
Driver Exit 



Bit Number 
15 14 13 



12 



11 



Done 

Initiate 

Wait 



0 
L 
M 



0 
0 
0 



0 

A 

I 



H 
H 
H 



T 
T 
T 



T = Set timeout on device request. 

H = Hold off new device request. 

A = Abort request on interface driver. 

I = Report illegal resume entry. 

L = Lock interface driver to this driver. 

M = Maintain previous lock (if any). 

LU LOCK FLAG is set by the system in response to an LU lock request. It consists of the ID 
segment number of the program which succeeded in gaining the lock. This field is zero if the 
device is not locked. 

The A bit is a flag set by the system to indicate an abort is in progress. This flag will remain 
set from the time the device driver is notified of abort until abort processing is complete, at 
which time the bit will be set to 0 by the system. 

RS, the Request State, is the status of the current DVT request. The driver may find it useful 
to examine the request state, for example, when it is called upon to abort the last request. 

If 0, the DVT request is linked on the IFT. Interface driver processing on this request 
has not yet begun. 

If 1, the DVT request is linked at the IFT head. It is currently being processed by the 
interface driver. 

If 2, the DVT request is linked for interface done. The interface driver has completed 
the current DVT request. The driver will never see RS = 2. 

If 3, the DVT request is linked for device done. The device driver has completed the 
current user request. The driver will never see RS = 3. 

If there is no pending request (no list on DVT2), then the request state is invalid and should 
not be examined. This could occur, for example, if a "resume" entry is made into a terminal 
driver as a result of someone striking the keyboard. 

DVT8 is Buffer Accumulator. If buffering is in effect, then this word is the total length of all 
buffered requests currently queued on the DVT. In addition, class requests, are always included in 
the accumulator. 

The B bit (15) is set if the device is buffered. 

DVT9 is Buffer Limits. This word stores the upper (HL) and lower (LL) buffer limits for the 
DVT HL is a positive 16-bit value defining the limit above which requests will become suspended. 
LL is also a positive 16-bit value. When the accumulated count in DVT8 falls below LL, programs 
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suspended for making a request when the accumulator was above the upper limit are allowed to 
repeat their requests. 

To preserve table space, the values are stored as (HL-LL)/16 and LL/16. Buffer limits may 
also be changed by an operator command. 

The S bit (15) is set if the device is buffer limited. When the limit is in effect, no new requests 
may be linked to the DVT. Programs which make buffered requests or class requests are, in 
this case, buffer-limit suspended. 

DVT10 is the starting physical page of the partition containing the data for the I/O request. This 
page number is adjusted for system common when necessary. 

DVT11 is Timeout List Linkage. This word is used to link all the DVTs and IFTs timeout clocks in 
a linked list. This list is ordered by timeout sequence, that is, the DVT which could time out first 
appears first in the list. 

The end of the list is terminated by zero (0) in word 11. If the DVT is not in the timeout list, 
then this word is set to minus one (-1). 

DVT12 is the Timeout Clock. This word is a negative value, in tens of milliseconds, which is the 
running timeout clock for the device driver. This value plus any other timeouts before this one in 
the linked list is the current timeout value for a particular DVT. 

DVT12 is initialized to 0 by the generator. The device driver must insert a negative value into 
DVT12 on each request if it wants timeout. In addition, it must set the "T" bit in the A 
register upon exit. 

On the initiate exit, the timeout clock starts when the request is initiated on the interface 
driver. On the wait or done exit the clock starts when the exit is made. The clock is cleared 
on entry to the device driver. 

DVT13 is a default timeout value for the interface driver when processing requests for this device. 

The value is negative and given in tens of milliseconds. This value is put into IFT2 when the 
device driver request is initiated on the interface driver. The timeout clock starts when the 
interface driver returns to the system with the "T" bit in the A register set. It stops when the 
interface driver is reentered. 

Timeout may be changed by the "TO" operator command. 

DVT14 is Device Driver Address. This word is the address of the entry point for the associated 
device driver. This is 0 if no device driver exists. This address will not be used if the user request 
specifies that the device driver be bypassed (bit 15 set to 1 in user request). 

DVT15 is Subfunction/Request Code. This word contains information about the user's request. 
Bits marked with an X are reserved for use by the system: 



TY 


UE 


Z 


SUBFUNCTION 


X X 


L 


BB 


RQ 
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SUBFUNCTION is derived from the ICNWD parameter of an EXEC request and provides 
control information about the request. The subfunction request is used differently according 
to whether the request is read/write (request code 1/2) or control (request code 3). 
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FOR READ OR WRITE REQUESTS (RQ = 1 or 2) : 



In order to provide device I/O transparency, particular control bits should be used to 
implement certain functions if applicable for the device. If these functions are not 
applicable for a device these bits, or combinations thereof may be used as desired. 

Expansion of SUBFUNCTION for a read/write request: 



11 


10 


9 


8 


7 


6 


DF 


TR 


DF 


EC 


DF 


Bl 



Bit Number 
Mnemonic 



DF is driver definable. 



TR, if 1/0, means transparency mode is/is not in effect. For nontransparency mode, 
terminators and/or embedded control characters may be removed or added by the driver 
on input or output. An example is a the "CRLF" on a write to a CRT. When 
transparency mode is in effect, driver addition or removal of information is restricted. 
Refer to the DD.00 section of the Driver Reference Manual. 



EC, if 1/0, indicates echo mode is/is not in effect. For echo mode the keyboard input is 
to be displayed as received. This is the normal mode of operation. 

Bl, if 1/0, means binary/ASCII information is to be transmitted. Refer to the DD.00 
section of the Driver Reference Manual. 

The subfunction bits should all be set to 1 if and only if the target device is a disk (type 
30-37). 



FOR CONTROL REQUESTS (RQ = 3) 



For control requests, the SUBFUNCTION field should follow the conventions below. 
Note that "(Tape)" stands for a tape unit (cassette drives or mag tape). 



Code Action 



00 Clear device 



01 


Write end-of-file (Tape) 


02 


Backspace one record (Tape) 


03 


Forward space one record (Tape) 


04 


Rewind (Tape) 


05 


Rewind standby (Tape) 


06 


Dynamic status 


07 


Set end-of media 



10B Set beginning of media 
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11B List output line spacing (space no. of lines in positive optional 
parameters) or form feed (optional parameter is negative). 

12B Write gap (Tape) 

13B Forward space file (Tape) 

14B Backward space file (Tape) 

15B Conditional form feed 

16B Go to remote 

17B Go to local 

20B Enable program scheduling. Allows interrupt to schedule a 
program 

21B Disable (inhibit) scheduling of program 

22B Set timeout. The optional parameter is set as the new interface 
timeout interval 

23B Expect asynchronous interrupt 

(optional parameter = 0/1 = enable/disable) 

24B Set device address (subchannel) 

25B Driver definable 

26B Driver definable 

27B Driver definable 

30-37B Reserved for system expansion 

40-77B Driver definable 

RQ is the request code: 

RQ Request type 

0 Multibuffered 

1 Read 

2 Write 

3 Control 

TY, or request type, is additional information which is normally of no interest to the driver. 
TY Request type 

0 Normal 

1 Buffered 

2 System 

3 Class 
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The Z bit is the double buffer bit. If Z = 0, then DVT18 and DVT19 are simple parameters 
(no additional buffer). Z=l designates that DVT18 is a second buffer address and DVT19 its 
length. This is applicable for read, write and control requests. 

The UE bit is the user error bit. If the UE bit is set, the calling program is expected to 
process the device errors that occur. The program should examine status, and error returns in 
the A-Register and extended status which are accessible through a RMPAR call. The 
RMPAR call should be made to an unbuffered device. The UE is 0, the system provides 
normal error handling. 

The UE bit is not functionally equivalent to the NS bit, which is described in the RTE-A 
Programmer's Reference Manual. Setting the UE bit only instructs the system to return error 
information to the calling program; the program is expected to process the returned error 
information. 

The BB bit is set to bypass the device driver. If the user has specified in the request that the 
device driver not be called, then this bit is set to 1 by the system. This means that the 
interface driver is called, bypassing the device driver. The driver need not be aware of this 
bit. 

This bit will also be set if the device driver has been called for abort processing and has 
rejected the request as illegal. 

The L bit is used by the system on read/write requests to indicate the source of data. 1 
indicates that the data buffer is in the user or SAM map; 0 indicates the data is in the system 
map. This bit must be saved in its exact position in order for the driver to access any data in 
the buffer passed to it in DVT16 (see Chapter 7, Callable System Routines, for a description 
of $READ, $WRIT, $ONER, or $ONEW). 

DVT16 is Request Parameter 1. This word serves two independent functions. On entering the 
driver, this word is the user's buffer starting address (RQ = 1 or 2) or optional control parameter 
(RQ=3). (NOTE: The buffer address must be used in conjunction with the $READ, $ONER, 
$WRIT, or $ONEW subroutines to access data in the data buffer. It cannot be used as the 
absolute address, however it can be used for calculating the relative address of any place in the 
buffer.) On exit, the driver reports error conditions in DVT16. 

DVT17 is Request Parameter 2. This word serves two independent functions. Entering the driver, 
this word is the number of words (if positive) or characters (if negative) to be transmitted, or is an 
optional control parameter. On exit, the driver posts a positive transmission log in either words or 
characters depending on the original request. If a negative number of bytes was requested, a 
positive number of bytes is posted in the transmission log. The maximum range on these 
parameters is +32768 words (100000B) or -32767 bytes (100001B). 

DVT18 is Request Parameter 3. This word may serve three distinct functions. If the Z bit in 
DVT15 is 0, then on an input request, it is another control parameter. If Z = 1 (control buffer), 
then DVT18 is a buffer address. This second buffer, in addition to DVT16, could be used for 
extended control information. The same rules for buffer access (see DVT16) apply. 

Upon returning to the system, DVT18 may contain device dependent error/status 
information. See the section (chapter 5) on Posting Errors for additional information. 

DVT19 is request Parameter 4. This word is like DVT18 except that if Z=l it is the length in 
words ( + ) or characters (-) of the buffer at DVT18. 
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DVT20 contains the Initial Entry Flag, the Driver Communication Flags and the Device Priority: 

The I bit is set to 1 by the generator for use by the driver as a "first entry" flag. If the driver 
takes any special action on first entry, it should clear this bit so that the action is not repeated 
on subsequent entries. 

DRIVER COMMUNICATION FLAGS are nine bits through which the device and interface 
driver may pass information or maintain common status information which both drivers 
require. The generator will set these bits to zero. 

DEVICE PRIORITY (0-63) is the priority assigned to this DVT for linking purposes on the 
IFT. Default linking is FIFO (priority ignored) unless the interface driver changes its Q bit 
(IFT3, Figure 2-4) to specify priority linking. 

DVT21 is the Number of Driver Parameters (bits 15 to 9) and Number of Extension Words (bits 8 
to 0). The driver may wish to check the number of extension words assigned on first entry to 
ensure that it does not overlay an area of memory not available to it. 

DVT22 is DVT Extension Address. This is the address of the first word of the DVT extension. 
The extension is a storage area for the device driver and should be used to store any temporary 
data needed to control a particular device. This extension lets a single device driver support 
several similar devices. 

The DVT extension is not contiguous to the rest of the DVT. 

Devices linked together in the circular node list (DVT3) share a common extension. 
Therefore, drivers should not expect data in the extension area from a previous request to be 
valid. 

DVT23 is the starting physical page number of the device driver if it was generated into a driver 
partition. The partitioned driver must be mapped into the system before being called. If the 
driver was not generated into a partition, DVT23 = 0. 

DVTP is Driver Parameter Area. Driver parameters are configuration type variables for the 
device driver. They may be set at generation time or optionally by a driver control request. A 
typical driver parameter is the device HPIB address. 

The generator will set all driver parameters not specified at generation time to zero. 

DVT24: If the M bit = 1, the current linked control block is located in SAM; otherwise, the M bit 
= 0. Bits 0-14 are reserved. 

DVT25 points to the spool node list if the device is being spooled. If DVT25=0, the device is not 
being spooled. 
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Interface Table I FT 



The interface table (IFT) is a variable length table constructed by the generator for each I/O card 
in the system. It is primarily a storage area for system I/O concerns, although the interface driver 
may examine the contents. The IFT extension is used by the interface driver for storage. 

The format of the interface table (IFT) is shown below. In the discussion which follows, the 
generator-initialized values are indicated. 





System 




Pointer 




Name 


IFT1 


$IF1 


IFT2 


$IF2 


IFT3 


$IF3 


IFT4 


$IF4 


IFT5 


$IF5 


IFT6 


$IF6 


IFT7 


$IF7 


IFT8 


$IF8 


IFT9 


$IF9 


IFTX 


$IFX 



15 14 13 12 11 10 



Timeout List Linkage 



Timeout Clock 



Q 



Request List Linkage 



Interface Driver Entry Address 



Device Table Address ($DVT1 ) 



AV 



Interface Type 



System Flags 



I/O select code 



F M # Words IFT Extension 



Starting Physical Page of Driver 



MA X ML OH MQ X X X X X X 



Map Set Number 



Start of IFT Extension (Storage) 
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Figure 2-4. Format of the Interface Table 

IFT1 is the Timeout List Linkage. DVTs and IFTs may be linked together in the timeout list. If 
this IFT is in the list, the contents of IFT1 point to the next IFT1 or DVT11. The list terminates in 
0. If this IFT is not in the list, IFT1 is set to —1 (initial value by generator). 

IFT2 is Timeout Clock. If active, this is a negative number indicating TBG ticks (10 millisecond 
intervals). It is not the actual timeout value when the timeout is active. 

Default timeout values for the interface driver are established in the DVT (see DVT13). The 
default value is stored in IFT2 upon entry to the interface driver. The interface driver can 
change the timeout value by changing IFT2. 

IFT3 is Request List Linkage. If active, bits 14 to 0 are the address of word 1 on some DVT. If 
inactive, bits 14 to 0 are set to 0 (initial value by generator). 

The Q bit is defaulted to 1 by the generator to indicate a FIFO list (queue). If priority linking 
is desired, the default may be changed at generation time. 

IFT4 is the Interface Driver Entry Address. Set by generator and not changeable. 

IFT5 is Device Table Address. Set by generator to word 1 of some DVT. May be changed on-line 
by the LA (logical assignment) operator command. The result of the LA command may be to 
clear this word to zero if no DVTs remain assigned to the IFT. 
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When the interface driver makes a resume or done exit, the system knows what device driver 
to enter to resume or continue the request by the contents of IFT5. Thus the interface driver 
may wish to control this word. See section on Asynchronous I/O and Polling. 

IFT6 is Interface card characteristics. 

AV is Availability, the current status of the I/O interface. It is used by the system for I/O 
control. 

AV Meaning 

00 IFT available 

01 IFT locked to some DVT. No other DVTs can get to the head of the list 
until the lock is released. 

10 IFT is busy. 

11 IFT is busy and is locked. 

INTERFACE TYPE identifies the type of I/O interface card which the interface driver is 
using. The generator defaults this value to the two octal digits within the interface driver 
name. 

I/O SELECT CODE is set on the interface card itself by switches and is an input to the 
generator. 

IFT7 contains the System Flags and the Extension Length. 

SYSTEM FLAGS are five bits used to store temporary flags. It is used by the system and not 
needed by the driver. The bits are defined below in brief. They are covered more completely 
in the section on System-Driver Interface: 

Type of Bit Number 



Driver Exit 


15 


14 


13 


12 


11 


Done 


Q 


D 


0 


H 


T 


Initiate 


0 


0 


I 


H 


T 


Resume 


0 


0 


0 


H 


T 



H = Hold off new interface driver request. 

T = Set timeout on interface request. 

I = Report illegal interrupt. 

Q = Inhibit advance to next request on IFT3. 

D = Defer entrance to the device driver. 

The EXTENSION LENGTH may be checked by the driver to insure that it is sufficient. 
Otherwise the driver may overlay an area of memory not allocated to it. The length is an 
input to the generator. 

The F bit is set to 1 by the generator for use by the driver as a "first entry" flag. If the driver 
takes any special action on first entry, it should clear this bit so that the action is not repeated 
on subsequent entries. 

The M bit is set to 1 if the driver manages its own timeout queuing and dequeuing. 
The bits marked "X" are reserved. 
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IFT8 is the starting physical page of the interface driver if the driver was generated into a driver 
partition. The partitioned driver must be mapped into the system before being called. If the 
driver was not generated into a partition, IFT8 = 0. 

IFT9 contains flags that deal with mapping I/O channels into map sets. 

The MA bit, when set, indicates that a map set is allocated for this I/O channel. 

The ML bit allows a map set to be locked to an I/O channel. When this bit is set, the system 
mapset deallocation routine, $MSRTN, will not deallocate the map set. 

The OH bit is used by RTE-A to store the state of the hold flag when an I/O request is 
map-set suspended. 

If the MQ bit is set, the I/O request associated with this IFT is on the map-set suspend queue. 

The Map Set Number, if the MA bit is set, will be the number of the map set that is allocated 
for this I/O channel. If the MA bit is clear, this field will be meaningless. 

The bits marked X are reserved. 

IFTX is IFT Extension. The interface driver should use this area for storage of all temporary data 
associated with a particular I/O card. This area should also be used for any short DMA transfers 
instead of doing I/O directly from the driver code space. A single interface driver may use several 
IFTs, hence support several distinct (identical) I/O cards. 



Interrupt Table INTA 

The interrupt table is of variable length and built by the system generator. It consists of one word 
entries for each processor I/O select code (channel). The first entry is for select code 20. The 
one-word entries are defined as follows: 

+ IFT address Address of the IFT corresponding to the interrupting select code. 

The system gains access to the interface driver via the IFT. 
zero Interrupt not expected (illegal) on this select code. Indicates 

generation or hardware failure. 



Map Set Table MST 

Map Set Table MST contains 24 words, each entry representing one of the map sets (numbered 8 
through 31). The meaning of each entry depends on the state of bit 15: 

Bit 15 Map Set Meaning of Bits 14-0 

0 Available Pointer to next free map (0 if end of list). 

1 Not Available Pointer to IFT that is using map set. 
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Table Pointers 



Global pointers are located in the system to permit access to the I/O tables. They are: 

LOGICAL UNIT TABLE (LUT) 

$LUTA Address of first word of logical unit table. 



$LUT# 



Number of defined logical units (entries) within the table. 



DEVICE TABLE (DVT) 

$DVTA Address of first DVT table entry. 



$DVT# 



Number of defined DVTs. 



$DV1 


Word 


1 


$DV2 




2 


$DV3 




3 


$DV4 




4 


$DV5 




5 


$DV6 




6 


$DV7 




7 


$DV8 




8 


$DV9 




9 


$DV10 




10 


$DV11 




11 


$DV12 




12 


$DV13 




13 


$DV14 




14 


$DV15 




15 


$DV16 




16 


$DV17 




17 


$DV18 




18 


$DV19 




19 


$DV2 0 




20 


$DV21 




21 


$DV22 




22 


$DV2 3 




23 


$DV2 4 




24 


$DV2 5 


Word 


25 



Together, $DV1 through $DV25 
specify the address of the 
word in the current DVT. 



$DVTP Address of current DVT parameter area. 

INTERFACE TABLE (IFT) 

$ I FT A Address of first IFT. 



$IFT# 



Number of defined IFTs. 
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$IF1 Word 1 



$IF2 2 

$IF3 3 Together, $IF1 through $IF9 

$IF4 4 specify the address of the 

$IF5 5 current IFT. 

$IF6 6 

$IF7 7 

$IF8 8 



$IF9 Word 9 

$ IFTX Address of current IFT extension. 

Each word in the current DVT and IFT can be accessed by adding a word count to a pointer to the 
first word, but the use of pointers to the words makes references to them easier to recognize in 
code, and it eliminates the need to use temporary variables to store the value of the word count 
plus the pointer. 

The pointers to the current IFT or DVT are set up by the system prior to entering the driver. 

INTERRUPT TABLE (INTA) 

$INTA Contains a list of numbers used to find interface driver entry points for 

interrupt processing. When the system recognizes an interrupt from an 
interface card, it adds the interface card select code to the INTA entry for that 
select code to form the address of the interface driver interrupt entry point. 

$INT# Number of defined entries in the interrupt table. 

The method used by the system to index to the proper location in the interrupt table is: 

LIB 4 GET INTERRUPTING SELECT CODE 



ADB $ INTA INDEX TO PROPER ENTRY 

The first user select code which can cause an interrupt is 20B. 

If the value of the associated entry in the interrupt table is zero, then the message: 

Illegal interrupt from SCnn 

is printed on the console. 
Map Set Table (Mst) 



$MST Contains the data for determining the current state of a map set. 

$MST# Contains the total number of map sets (24). 

$MSFRE Points to the first free entry on the map-set free list linked within the map set 
table ($MST). If no map sets are available, this entry will be zero. 

$MSA Points to the location where map set number 0 ($MST-8) would be stored if it 



were in the map set table. 
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System-Driver Interface 

The system enters the device driver as indicated below. The address of the driver is picked up 
from the DVT 

All pointers to the DVT, as described in the chapter on System I/O Tables, are set prior to entering 
the driver. The registers and calling sequence are: 

A-Register = Entry Directive (bits 2-0) 
B -Register = DVT Address 

JSB DD.XX 
P+l done 

P+2 interface initiate 
P+3 wait 

On exit, bits 4-0 of the A-Register are placed in bits 15-11 of DVT7 (the System Flags area). 

The various entry directives and their codes in the A-Register (binary) are: 
Code Meaning 

000 Abort 

001 Initiate 

010 Continue 

011 Time Out 

100 Power Fail 

101 Resume 

The driver should mask off the high order bits of the A-Register, as they are reserved for future 
changes. 



Device Driver 3-1 



The driver must increment its return address, stored at its entry point, to the proper exit as 
follows: 



Source Code 


Meaning 


A-Register on Exit 


TMP nn nn T 

J L\±L ISIS. 1111 j 1 

P+l return 


IVCUUCSL CVJIIIUICIC' 

on device driver. 


u \j \j 1 1 ± 


ISZ DD.nn 
JMP DD.nn,I 
P+2 return 


Initiate request 
on interface driver. 


L 0 A H T 


ISZ DD.nn 
ISZ DD.nn 
JMP DD.nn,I 
P+3 return 


Wait for resume 
entry from interface 
driver or device 
timeout. 


MOIHT 



Upon exit from the driver, bits 0-4 of the A-Register are stored in the system flags area of DVT7. 
The meanings of the bits, if set, are: 



T = Set timeout on device driver request. 

H = Hold off new device driver request initiation. 

A = Abort request on interface driver. 

I = Report illegal resume entry. 

L = Lock interface driver to this device driver. 

M = Maintain previous lock (if any). 



If the interface driver is locked, the DVT will remain at the head of the IFT upon an interface 
done exit. This prevents interleaving of requests from multiple DVTs on the same IFT. 

The H bit holds off all initiate entries from RTE-A. Therefore, if the H bit is set on a done exit, 
the driver must plan on subsequent entry by device timeout or asynchronous resume. 



3-2 Device Driver 



Entry Directives 



The system will set up the pointers to the DVT before entering the driver. If the device driver 
wishes to access the IFT, it should call the routine $DIOC (described in Chapter 7). 

Upon entry, the directive code will be in the A-Register bits 2-0. The driver should mask off the 
high order bits as they are reserved for future use. The DVT address will be in the B -Register. 

Initiate New Request 

Upon entry, bits 2-0 of the A-Register equal 001. 

This entry is made when a new request is to be started. The request code (for read, write or 
control) is in DVT15 with parameters in DVT16 through DVT19. Additional information may be 
contained in the driver parameter area. The driver should first determine whether or not the 
request is applicable (for instance, a read request on a printer makes no sense) and, if not 
applicable, make an error exit. 

Then the parameters may be checked against the device characteristics. For example, a read 
request to a disk may contain a track number that is outside the range. If so, the driver should 
make an error exit. 

Illegal requests may be ignored by the driver by making an immediate normal completion exit. 

If a legal request and device operation is required, the device driver formats one or more requests 
for the interface driver and makes an "interface initiate" exit. All information about the request 
to the interface driver must be contained in some area commonly agreed upon, typically the driver 
communication area in DVT20 or the DVT extension. Examination or modification of request 
data buffers should always take place through system supplied I/O system routines. (See the 
section on Mapping Considerations.) 

Prior to making a request on the interface driver, the device driver may change the request by 
altering the request parameters. Or it may set bits in the driver communication area of DVT20 as 
flags to the interface driver. 

Resume Interrupt Processing 

Upon entry, bits 2-0 of the A-Register equal 101. 

This entry is made because the system has received a "resume" exit from the interface driver; the 
device driver is called to resume processing. A possible reason for the interrupt is that someone 
struck a key at a terminal upon which there was no pending read request. 

Typically, the resume exit is used to distinguish an asynchronous interrupt from an expected 
interrupt, which uses the continue entry. In the usual case the driver should take a 'wait' exit after 
a resume entry. 
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Continue Processing 



Upon entry, bits 2-0 of the A-Register = 010. 

This entry is made to continue the processing of the current request which the device driver has 
made upon the interface driver (always synchronous with what the device driver is doing). 

The interface driver is done with the request. The device may initiate another request upon the 
interface driver or complete the request by making a done exit. 

The driver might make another request, for example, in the case of a device requiring some 
extended protocol. In the case of the HP terminals, before sending/receiving data to/from the 
terminal the driver first sends an ENQ (enquiry) character. When the terminal is able to respond, 
it sends back an ACK (acknowledge). The ENQ/ACK handshake is given to the interface driver as 
one request; when it completes, the actual output buffer is given to the interface driver in another 
request. 

Timeout Processing 

Upon entry, bits 2-0 of the A-Register equal Oil. 

This entry is made when the clock in DVT12 completes the timeout period. 

The timeout period for a device driver cannot be established at generation time. It is enabled by 
the driver setting the timeout bit in the A-Register on exit and its value determined by the contents 
of DVT12 at that time. The value should be a negative number whose absolute value indicates the 
number of Time Base ticks desired. Each tick is .01 second and so the time in seconds is found by 
dividing the value by 100. DVT12 is cleared by the system prior to entering the driver. 

The clock starts immediately upon done or wait exit. If the exit is to initiate a request on the 
interface driver, then the clock starts upon entry to the interface driver. 

The action taken on timeout may vary greatly from device to device. For example, a 
communications terminal driver may wish to keep itself in the timeout list until a "line open" 
condition is detected. Thus, it might call the interface driver upon receiving timeout to detect the 
open condition. If not received, it would, again, set itself up for timeout. 

Device timeout may easily be confused with the timeout of the interface request but it is not the 
same. The default timeout value for the interface is taken from DVT13, and is unique to each 
device request on the interface driver. An interface timeout causes entry into the interface driver, 
and a device timeout causes entry into the device driver. 

Abort Request 

Upon entry, bits 2-0 of the A-Register equal 000. 

The device driver may be called to abort the current request if an I/O request is in progress and 
the program is aborted. The device driver must terminate the request as rapidly as possible within 
the limits of the device. 

Prior to entering the driver (device or interface) the "A" bit in DVT7 is set to indicate that abort 
processing is in progress. It will be reset when abort processing is completed by the drivers. 
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The device driver may find it useful to examine IFT5 (backward reference to current DVT), IFT6 
(availability field) and DVT7 (device request status, RS) in order to decide what action is 
appropriate. 

The request to be aborted may be in process by the interface driver (RS = 1) or it may simply be in 
the list (RS=0). For example, a poll request may be active on several devices on the HP-IB. 

There are several possible options open to the device driver. It may: 

1. Initiate an abort request on the interface driver. The request will take precedence over any 
request on the interface driver now in progress for that device. 

2. Defer abort processing until the request completes. An abort may not be in the best interest 
of the device being controlled. 

3. Allow the system to be totally responsible for abort processing on the interface driver by 
rejecting the abort request as "illegal". Normally, a request which is rejected as illegal causes 
an error message but if the abort request is rejected by the device driver, no message is issued. 
The abort request is passed on to the interface driver. 

If the device driver elects to take the "wait" exit, then the system will ensure that timeout is active. 
If no timeout is specified by the driver, then a default of 1 second will be supplied. The driver will 
be entered again at the end of the timeout, or at the completion of the request. If the timeout 
occurs, the driver may check the "A' bit in DVT7 to determine that abort processing is in progress. 

Abort processing completes when the device driver makes a done exit. 

Power-Fail Restart 

Upon entry, bits 2-0 of the A-Register are set to 100. 

The device driver will be called on power-fail restart only if it has indicated that it should be 
called. The driver indicated that it should be called to process power-fail restarts by setting P bit 
in DVT4. If the driver processes power-fail, then it will be called upon every power failure, but 
only if it was busy at the time the failure occurred. 



Driver Exit 

Upon driver exit, there are three concerns: 

1. Setting of system flags through bits in the A-Register. 

2. Posting status in the DVT. 

3. Posting any errors, in addition to status. 

The system flags are set regardless of whether the exit is to indicate "done," "interface initiate" or 
"wait." However, status and errors are posted only on the done exit. 
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It is important to remember that the status of the transfer of data and any transfer errors should 
be posted by the interface driver. The device driver handles only device-dependent status and 
errors. 

The topics of status and error posting are common to both the device driver and the interface 
driver and so they are covered in the chapter on General Driver Concerns. 

System Flags 

The three possible exit sequences from the device driver are given below. For each exit, bits 4-0 of 
the A- Register have the meaning indicated. The B -Register is meaningless. 

The system takes the contents of A- Register bits 4 through 0 and places them in the system flags 
areaofDVT7. 



A-Register Bit: 


4 


3 


2 


1 


0 


P + 1 "Done" 


0 


0 


0 


H 


T 


P + 2 "Initiate" 


L 


0 


A 


H 


T 


P + 3 "Wait" 


M 


0 


I 


H 


T 



L88-334 



T means set timeout. If set, the system will enter the device driver in the timeout list. See 
Timeout Processing. 

H means hold. If set, the system will delay calling the device driver to start a new request. 
The driver normally sets this bit only to allow it to process interrupts through the resume 
entry, with device timeout in effect. 

A means abort. If set, the system will call the interface driver with an abort directive. 
I indicates illegal resume entry. If set, the system will issue an error message of the form: 

Illegal interrupt from LU nn octal 

where nn is the current logical unit number pointing to the DVT. 
The bit should only be set in the case of an illegal resume entry. 

L means lock IFT to DVT. If set, the DVT will remain at the head of the IFT upon "interface 
done." This prevents interleaved requests from several device drivers on one interface driver. Not 
every driver will encounter situations where it is necessary to use this bit. 

A side benefit of the lock is that the DVT will not be unlinked and relinked to the interface 
driver as one request completes and another is initiated. Thus, if the device driver knows that 
it has several requests to execute at "high speed," it may lock the IFT to reduce overhead. 

M means maintain lock. On subsequent exits from the driver, a previously locked IFT will remain 
locked only if this bit remains set to 1. Note that an IFT will never remain locked on a device 
done exit. 

The illegal interrupt on LU nn message is also produced when the device driver takes a 'Done' exit 
when no request is active on the DVT. 
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Sample Device Driver 



This section contains a listing for a sample terminal driver. Many of the features of the driver are 
not explained in detail in the manual because they are not essential to the structure of the driver. 
That is, there are many different ways the same result could be achieved and this listing represents 
one programmer's approach. 

Although this sample driver has been tested, it is not guaranteed to correspond to the code in any 
driver shipped with the system. It is included here only as an example. 



ASMB, R, L, C 



NAME: 
SOURCE: 
RELOC: 
PGMR: 



DD. 2 0 

92077-18727 
92077-16727 
T.A.L. 



REPLACING XL VERSION 92071-18084 
REPLACING XL VERSION 92071-16084 



*************************************************************** 

* (C) COPYRIGHT HEWLETT-PACKARD COMPANY 1980. ALL RIGHTS * 

* RESERVED. NO PART OF THIS PROGRAM MAY BE PHOTOCOPIED, * 

* REPRODUCED OR TRANSLATED TO ANOTHER PROGRAM LANGUAGE WITHOUT* 

* THE PRIOR WRITTEN CONSENT OF HEWLETT-PACKARD COMPANY. * 

************************ 



NAM DD . 2 0 , 0 



92077-16727 REV. 2441 <881012 . 1510> 



ENT DD.2 0 

EXT $DV6, $DV15, $DV16, $DV17, $DV18, $DV19, $DV22 
EXT $DVTP, $CVT3, $CVT, $ONER, $ONEW, $DV1, . MVW 

GEN 1,PA 

GEN 19, EDD . 20, TX : 45, TO: 3000, DT : 2 0B, QU:FI 
GEN 2,DX:1 

GEN 7,M2 645:1,DP:1:1 
GEN 7,M2645:2,DP:1:2 

GEN 7,M2 64X:1,DP:1:1 
GEN 7,M2 64X:2,DP:1:2 



000000 A 

000001 B 



EQU 0 
EQU 1 



0000 000000 DD.20 NOP 

0001 070030R STA DIREC 

0002 015175R JSB SETAD 

0003 060030R LDA DIREC 



SAVE DIRECTIVE 

SETUP EXTENSION ADDR PTR' S 

GET DIRECTIVE 
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00004 


010025R 




AND 


B7 




00005 


002002 




SZA 




ABORT? 


00006 


024013R 




JMP 


GO 


NO 


* ABORT * 










00007 


171260R 




STA 


DVX14, I 


ZERO CHARACTER ACCUMULATOR 


0 0 010 


U 0 U 4 3 / K 




LDA 


B4 


CALL INTERFACE DRIVER 


00011 


015155R 




JSB 


CEXIT 


WITH ABORT CODE 


n n n i o 
DDI) 1 Z 

-k 


A O R 1 o A-n 
UZOl jUK 




JMP 


DDCM2 


DEVICE COMPLETE 


ic 

UUUl j 


A C A A O O D 

U 0 U U Z Z K 


GO 


CPA 


Bl 


INITIATE? 


nnrn /i 

UUU14 


A O /] A Q -1 T> 

UZ^U jiK 




JMP 


INIT 


YES 


UUUlO 


A C; A A O O "D 

U 0 U U Z jK 




CPA 


B2 


CONTINUATION? 


00016 


025164R 




JMP 


CONT 


YES 


nnrn i 

UUUl/ 


n r n n o zip 

UOUUZ4K 




CPA 


B3 


TIMEOUT? 


00020 


025130R 




JMP 


DDCM2 


YES, DEVICE COMPLETE 


00021 


025121R 




JMP 


DDCOM 


DEVICE COMPLETE 


uuuzz 


000001 


Bl 


OCT 


1 




U U U Z o 


000002 


B2 


OCT 


2 




D D D Z 4 


000003 


B3 


OCT 


3 




n n n 9 r 
u u u z 0 


000007 


B7 


OCT 


7 




n n n o c 
u u u z o 


177767 


M9 


DEC 


-9 




UUUZ / 


177765 


Mil 


DEC 


-11 




U U U o D 

•k 


000000 


DIREC 


NOP 




DIRECTIVE 


-k 

k TMTT 

INI 1 

k 


'IATION * 








UUU jl 


061240R 


INIT 


LDA 


ESCC 


GET <ESCc> LOCK KEYBOARD 




171246R 




STA 


DVX4 , I 


SAVE IT 


UUU jj 


061214R 




LDA 


ESC& 


GET <ESC&> 


UUU o4 


171247R 




STA 


DVX5 , I 


SAVE IT 


A A a o c 


160010X 




LDA 


$DVTP, I 


GET CTU (1 OR 2) 


00036 


030230R 




IOR 


PLU 


MERGE <p60> 


00037 


171250R 




STA 


DVX6, I 


SAVE <p61 OR p62> 


00040 


160002X 




LDA 


$DV15, I 


GET SUBFUNCTION 


00041 


171261R 




STA 


DVX15, I 


SAVE IT 


00042 


014642R 




JSB 


ASCWT 


ASCII WRITE (SYSTEM ADDR . SPACE) 


00043 


161261R 




LDA 


DVX15, I 


GET RQ 


00044 


010024R 




AND 


B3 




00045 


050024R 




CPA 


B3 


CONTROL REQUEST? 


00046 


024420R 




JMP 


CNTRL 


YES 


00047 


160001X 




LDA 


$DV6, I 


GET DEVICE STATUS 


00050 


010411R 




AND 


LBYTE 


REMOVE OLD STATUS 


00051 


170001X 




STA 


$DV6, I 
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052 


161261R 


LDA 


DVX15, I 


GET SUBFUNCTION 


053 


010227R 


AND 


ECHO 


REMOVE ECHO BIT 8 


054 


171261R 


STA 


DVX15, I 


SAVE INITIAL SUBFUNCTION MINUS ECHO BI 


055 


010024R 


AND 


B3 


GET RQ 


056 


164003X 


LDB 


$DV16, I 


GET BUFFER ADDR 


057 


175244R 


STB 


DVX2, I 


SAVE INITIAL ADDR. 


060 


065246R 


LDB 


DVX4 


GET ESC SEQUENCE ADDR. 


061 


174003X 


STB 


$DV16, I 


SAVE IT 


062 


164004X 


LDB 


$DV17, I 


GET XLOG 


063 


175255R 


STB 


DVX11, I 


SAVE INITIAL XLOG (-CHARS OR +WORDS) 


064 


006020 


SSB 




CHARACTERS? 


065 


024070R 


JMP 


* + 3 


YES, SAVE THEM 


066 


007004 


CMB, 


INB 


NO, CONVERT TO 


067 


005000 


BLS 




- CHARACTERS 


070 


175245R 


STB 


DVX3, I 


SAVE -CHAR LENGTH 


071 


050022R 


CPA 


Bl 


READ REQUEST? 


072 


024240R 


JMP 


READ 


YES 



* 
* 



* WRITE REQUEST * 

* 



00073 


161245R WRITE 


LDA 


DVX3, I 


GET -CHAR LENGTH 


00074 


003004 


CMA, 


INA 


MAKE CHARACTERS POSITIVE 


00075 


165261R 


LDB 


DVX15, I 


GET SUBFUNCTION 


00076 


005727 


BLF, 


BLF 




00077 


005200 


RBL 






00100 


006020 


SSB 




ASCII? 


00101 


002001 


RSS 




NO, CHARACTER LENGTH OK 


00102 


040023R 


ADA 


B2 


YES, ADD TWO TO LENGTH FOR ' CRLF ' 


00103 


065120R 


LDB 


M257 




00104 


044000 


ADB 


A 




00105 


006020 


SSB 




LENGTH > 25 6? 


00106 


002003 


SZA, 


RSS 


ZERO XLOG? 


00107 


024454R 


JMP 


ERROR 


YES, ILLEGAL REQUEST ERROR 


00110 


002300 


CCE 




E=l FOR DECIMAL 


00111 


014011X 


JSB 


$CVT3 


CONVERT +CHAR'S TO ASCII 


00112 


061232R 


LDA 


DN 




00113 


030012X 


IOR 


$CVT+1 




00114 


171251R 


STA 


DVX7, I 


SAVE <dSPACE OR NUMBER> 


00115 


060012X 


LDA 


$CVT+2 




00116 


171252R 


STA 


DVX8, I 


SAVE <NUMBER> TO WRITE 


00117 


061233R 


LDA 


W 


GET <W> 


00120 


171253R 


STA 


DVX9, I 


SAVE <W> 


00121 


060027R 


LDA 


Mil 




00122 


170004X 


STA 


$DV17, I 


BUFFER LENGTH 


00123 


002404 


CLA, 


INA 


ALLOW TIMEOUT 


00124 

* 


015155R 


JSB 


CEXIT 


INITIATE WRITE ESCAPE SEQUENCE 


00125 


015060R 


JSB 


FPORT 


FLUSH PORT BUFFERS FOR MUX 
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00126 015155R JSB CEXIT 

* 



00127 


065234R 


LDB 


ENQ 


00130 


174 0 0 6X RACK 


STB 


$DV19, I 


00131 


161261R 


LDA 


DVX15, I 


00132 


020024R 


XOR 


B3 


00133 


010237R 


AND 


SBIT 


00134 


170002X 


STA 


$DV15, I 


00135 


061262R 


LDA 


DVX16 


00136 


170003X 


STA 


$DV16, I 


00137 


003400 


CCA 




00140 


170004X 


STA 


$DV17, I 


00141 


002400 


CLA 




00142 


170005X 


STA 


$DV18, I 


00143 


002004 


INA 




00144 
* 


015155R 


JSB 


CEXIT 


00145 


006400 


CLB 




00146 


161262R 


LDA 


DVX16, I 


00147 


010411R 


AND 


LBYTE 


00150 


050236R 


CPA 


ACK 


00151 


002001 


RSS 




00152 

* 


024130R 


JMP 


RACK 


00153 


161261R 


LDA 


DVX15, I 


00154 


010226R 


AND 


CBIT7 


00155 


030225R 


IOR 


BIT8 


00156 


170002X 


STA 


$DV15, I 


00157 


161244R 


LDA 


DVX2, I 


00160 


170003X 


STA 


$DV16, I 


00161 


161245R 


LDA 


DVX3, I 


00162 


170004X 


STA 


$DV17, I 


00163 


002400 


CLA 




00164 


170005X 


STA 


$DV18, I 


00165 


002004 


INA 




00166 

* 


015155R 


JSB 


CEXIT 


00167 


160004X 


LDA 


$DV17, I 


00170 


171260R 


STA 


DVX14, I 


00171 


014204R 


JSB 


STAT 


00172 


015155R 


JSB 


CEXIT 


00173 


006400 


CLB 




00174 


161256R 


LDA 


DVX12, I 


00175 


010411R 


AND 


LBYTE 


00176 


050232R 


CPA 


S 


00177 


024202R 


JMP 


DONE 


00200 


175260R 


STB 


DVX14, I 


00201 


014662R 


JSB 


DYST 



INITIATE CNTRL REQ . 2 6B FOR MUX 

GET ENQUIRY 

SAVE 'ENQ' OR ZERO 

GET RQ 

MAKE SURE ITS A ASCII READ 
(SYSTEM ADDR. SPACE) 
SAVE IT 

GET 1 BYTE READ ADDRESS 
SAVE IT 
BUFFER LENGTH 
SAVE IT 

ZERO ASIC CONTROL WORD 

ALLOW TIMEOUT 

SEND 'ENQ', READ 'ACK' 

CLEAR 'ENQ' 

GET BYTE READ 

REMOVE LOW BYTE 

'ACK' RECEIVED? 

YES, CONTINUE 

NO, RETRY FOR ACK ONLY 

GET SUBFUNCTION 
ADD ' CRLF ' 

SET 'DISABLE HANDSHAKE' BIT FOR MUX 
(USER ADDR. SPACE) 
GET INITIAL BUFFER ADDRESS 
SAVE IT 

GET INITIAL BUFFER LENGTH 
SAVE IT 

ZERO ASIC CONTROL WORD 
ALLOW TIMEOUT 
INITIATE WRITE 

GET XLOG (+CHAR'S) 

SAVE IN EXTENSION 

SETUP FOR 2 CHAR READ 

SEND DC1, READ 'S' OR 'F' 

ZERO ERROR CODE 

GET COMPLETION STATUS 

REMOVE LOW BYTE 

SUCCESSFUL? 

YES (B=ERROR CODE) 

NO, ZERO XLOG 

GET DYNAMIC STATUS 
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00202 


174003X 


DONE 


STB 


SDV16, I 


00203 

* 


025121R 




JMP 


DDCOM 




00204 


000000 


STAT 


NOP 






00205 


061256R 




LDA 


DVX12 




00206 


170003X 




STA 


$DV16, I 


00207 


060231R 




LDA 


M2 




00210 


170004X 




STA 


$DV17, 


I 


00211 


161261R 




LDA 


DVX15, I 


00212 


010661R 




AND 


RQASC 




00213 


002004 




INA 






00214 


010237R 




AND 


SBIT 




00215 


170002X 




STA 


$DV15, 


I 


00216 


002400 




CLA 






00217 


170005X 




STA 


$DV18, 


I 


00220 


060407R 




LDA 


DC1 




00221 


170006X 




STA 


$DV19, 


I 


00222 


002404 




CLA, 


INA 




00223 

* 


124204R 




JMP 


STAT, I 




00224 


000100 


BIT6 


OCT 


100 




00225 


000400 


BIT8 


OCT 


400 




00226 


177577 


CBIT7 


OCT 


177577 




00227 


177377 


ECHO 


OCT 


177377 




00230 


070060 


PLU 


OCT 


70060 




00231 


177776 


M2 


DEC 


-2 




00232 


051400 


S 


OCT 


51400 




00233 


140001 


ILREQ 


OCT 


140001 




00234 


017015 


RS.CR 


OCT 


17015 




00235 


006415 


CR. CR 


OCT 


6415 




00236 


003000 


ACK 


OCT 


3000 




00237 
* 


177767 


SBIT 


OCT 


177767 




* 

* READ REQUEST * 
* 








00240 


060024R 


READ 


LDA 


B3 




00241 


006003 




SZB, 


RSS 




00242 


024525R 




JMP 


FSRF 




00243 


061235R 




LDA 


S2 




00244 


171251R 




STA 


DVX7, I 




00245 


061236R 




LDA 


R 




00246 


171252R 




STA 


DVX8, I 




00247 


060026R 




LDA 


M9 




00250 


170004X 




STA 


$DV17, 


I 


00251 


002404 




CLA, 


INA 




00252 


015155R 




JSB 


CEXIT 





SETUP ERROR CODE 
DEVICE COMPLETE 

SETUP FOR 2 CHAR READ 
GET READ ADDRESS 
SAVE IT 
BUFFER LENGTH 
SAVE IT 
GET RQ 

MAKE SURE ITS A ASCII READ 
RQ=1 

(SYSTEM ADDR. SPACE) 
SAVE IT 

ZERO ASIC CONTROL WORD 
SETUP DC1 

IN OPTIONAL PARAMETER 
ALLOW TIMEOUT 
RETURN 



BINARY BIT 6 

'DISABLE HANDSHAKE' BIT 

ADD ' CRLF ' 

ZERO ECHO BIT 8 

<p60> 

<S> 

ILLEGAL REQUEST 

RECORD SEPERATOR CARRIDGE RETURN 
CARRIAGE RETURN CARRIAGE RETURN 
'ACKNOWLEDGE' 
ZERO S BIT (BIT 3) 



ZERO XLOG? 

YES, FORWARD SPACE ONE RECORD 

GET <s2> 

SAVE IT 

GET <R> 

SAVE IT 

BUFFER LENGTH 

SAVE IT 

ALLOW TIMEOUT 

SEND READ ESCAPE SEUQENCE 
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00253 


015060R 


JSB 


FPORT 




00254 

* 


015155R 


JSB 


CEXIT 




00255 


060407R 


LDA 


DC1 




00256 


170006X READ 5 


STA 


$DV19, 


I 


00257 


161261R 


LDA 


DVX15, 


I 


00260 


030224R 


IOR 


BIT6 




00261 


010237R 


AND 


SBIT 




00262 


170002X 


STA 


$DV15, 


I 


00263 


061262R 


LDA 


DVX16 




00264 


170003X 


STA 


$DV16, 


I 


00265 


060654R 


LDA 


M5 




00266 


170004X 


STA 


$DV17, 


I 


00267 


060410R 


LDA 


B1415 




00270 


170005X 


STA 


$DV18, 


I 


00271 


002404 


CLA, 


INA 




00272 
* 


015155R 


JSB 


CEXIT 




00273 


002400 


CLA 






00274 


164004X 


LDB 


$DV17, 


I 


00275 


054022R 


CPB 


Bl 




00276 


024256R 


JMP 


READ 5 




00277 


165261R 


LDB 


DVX15, 


I 


00300 


174002X 


STB 


$DV15, 


I 


00301 


165262R 


LDB 


DVX16, 


I 


00302 


054234R 


CPB 


RS.CR 




00303 


024414R 


JMP 


ZEROL 




00304 


054235R 


CPB 


CR.CR 




00305 


024414R 


JMP 


ZEROL 




00306 


170005X 


STA 


$DV18, 


I 


00307 


161244R 


LDA 


DVX2, I 




00310 


170003X 


STA 


$DV16, I 


00311 


161262R 


LDA 


DVX16, 


I 


00312 


165263R 


LDB 


DVX17, I 


00313 


005700 


BLF 






00314 


100104 


RRL 


4 




00315 


005700 


BLF 






00316 


100104 


RRL 


4 




00317 


001700 


ALF 






00320 


101104 


RRR 


4 




00321 


003007 


CMA, 


INA, SZA 


00322 


024414R 


JMP 


ZEROL 




00323 


070001 


STA 


B 




00324 


007004 


CMB, 


INB 




00325 


103101 


CLO 






00326 


175257R 


STB 


DVX13, 


I 


00327 


145245R 


ADB 


DVX3 , I 




00330 


102301 


SOS 






00331 


006021 


SSB, 


RSS 





FLUSH PORT BUFFERS FOR MUX 
INITIATE CNTRL REQ . 2 6B FOR MUX 

SETUP FOR 

DC1 CODE IN UPPER BYTE 
GET INITIAL SUBFUNCTION 
SET BINARY BIT 
(SYSTEM ADDR. SPACE) 
SAVE IT 

GET DRIVER EXTENSION ADDR 
SAVE IT 
BUFFER LENGTH 
SAVE IT 

SETUP FOR SPECIAL CHAR (CR) 
IN ASIC CONTROL WORD 
ALLOW TIMEOUT 
SEND DC1, READ 5 BYTES 

ZERO ASIC CONTROL WORD 
GET XLOG (+CHARS) 

ASYNCHRONOUS INTERRUPT RECEIVED 
YES, TRY AGAIN (REQ. FOR MUX) 
GET INITIAL SUBFUNCTION 
(USER ADDR. SPACE) 
GET LAST CHARACTERS READ 
RSCR? 

YES, END OF READ 
CRCR? 

YES, RETURN KEY STRUCK 
SAVE ASIC CONTROL WORD 
GET INITIAL BUFFER ADDR 
SAVE IT 

GET FIRST AND SECOND BYTES 
GET THIRD AND FOURTH BYTES 
MERGE THE FOUR 
BYTES IN ORDER 
TO FIND 
BUFFER LENGTH 



: BUFFER LENGTH ZERO? 
YES, READ STATUS 
SAVE LENGTH 

MAKE LENGTH POSITIVE (+CHAR'S) 
CLEAR OVERFLOW 

SAVE REQUEST LENGTH (+CHARS) 
ADD ORIGIONAL LENGTH (-CHAR'S) 
SKIP OVERFLOW SET 

REQUEST LENGTH >= BUFFER LENGTH 
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00332 


161245R 




LDA 


DVX3, I 


YES, USE BUFFER LENGTH 


00333 


170004X 




STA 


$DV17, I 


SAVE LENGTH (-CHARS) 


00334 


006020 




SSB 




REMAINING LENGTH POSITIVE? 


00335 


006400 




CLB 




NO, ZERO INTERRUPTS TO BIT BUCKET 


00336 


060407R 




LDA 


DC1 


DC1 IN UPPER BYTE 


00337 


030001 




IOR 


B 


MERGE REMAINING INTERRUPTS TO BIT BUCKET 


00340 


170006X 




STA 


$DV19, I 


SAVE DC1 + INTERRUPTS TO BIT BUCKET 


00341 


002404 




CLA, 


INA 


ALLOW TIMEOUT 


00342 

* 


015155R 




JSB 


CEXIT 


SEND DC1, READ DVT 17 BYTES 


00343 


160002X 




LDA 


$DV15, I 


GET SUBFUNCTION 


00344 


101046 




LSR 


6 




00345 


164004X 




LDB 


$DV17, I 


GET XLOG (+CHARS) 


00346 


000010 




SLA 




ASCII? 


00347 


024357R 




JMP 


XLOG 


NO, DO NOT ADJUST XLOG 


00350 


161257R 




LDA 


DVX13, I 


YES, GET REQUEST LENGTH (+CHARS) 


00351 


040405R 




ADA 


Ml 


SUBTRACT ONE 


00352 


141245R 




ADA 


DVX3, I 


ADD BUFFER LENGTH (-CHARS) 


00353 


002003 




SZA, 


RSS 


(RL-1) = BL? 


00354 


044405R 




ADB 


Ml 


YES, XLOG = XLOG -1 


00355 


002020 




SSA 




(RL-1) < BL? 


00356 


044231R 




ADB 


M2 


YES, XLOG = XLOG - 2 


00357 


006020 


XLOG 


SSB 




XLOG NEGATIVE? 


00360 


006400 




CLB 




YES, ZERO XLOG 


00361 


175260R 




STB 


DVX14, I 


SAVE XLOG (+CHAR'S) 


00362 


004065 




CLE, . 


ERB 


E=0/1, ODD/EVEN 


00363 


145266R 




ADB 


DVX2 0, I 


FIND LAST CHAR ADDR. 


00364 


002041 




SEZ, 


RSS 


LAST CHAR EVEN? 


00365 


025121R 




JMP 


DDCOM 


NO, DEVICE COMPLETE 


00366 


075213R 




STB 


TEMP 


SAVE CHARACTER ADDR PTR 


00367 


014013X 




JSB 


$ONER 


YES, GET LAST WORD 


00370 


101261R 




DEF 


DVX15, I 




00371 


100015X 




DEF 


$DV1, I 




00372 


010411R 




AND 


LBYTE 


REMOVE LOWER BYTE (SPEC CHAR) 


00373 


164002X 




LDB 


$DV15, I 


GET SUBFUNCTION 


00374 


005727 




BLF, 


BLF 




00375 


005200 




RBL 






00376 


006021 




SSB, 


RSS 


BINARY? 


00377 


030406R 




IOR 


B40 


NO, PAD WITH A BLANK 


00400 


065213R 




LDB 


TEMP 


GET CHARACTER ADDR PTR 


00401 


014014X 




JSB 


$ONEW 


RESTORE WORD 


00402 


101261R 




DEF 


DVX15, I 




00403 


100015X 




DEF 


$DV1, I 




00404 

* 


025121R 




JMP 


DDCOM 


DEVICE COMPLETE 


00405 


177777 


Ml 


DEC 


-1 




00406 


000040 


B40 


OCT 


40 




00407 


010400 


DC1 


OCT 


10400 


DC1 CODE IN UPPER BYTE 


00410 


140000 


B1415 


OCT 


140000 


SPECIAL CHAR (CR) 
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00411 
* 


177400 


LBYTE 


OCT 


177400 


* 

* ZERO LENGTH 

* 


READ /DYNAMIC STATUS 


00412 


060232R 


TICST 


LDA 


S 


00413 


002001 




RSS 




00414 


171260R 


ZEROL 


STA 


TAT 7V 1/1 T 

u VX1 4 , 1 


00415 


171256R 






TAT 7"V 1 O T 


00416 


014662R 




TCD 


JJ I o 1 


00417 


024202R 




TMD 


TAiATYnr 1 
DONE 


* CONTROL REQUEST * 
* 






n n a 9 n 

U U 4 Z U 


1 £ 1 9 £ 1 R 
_L O -L Z O -L JA 


^ In ± JA J_i 


IjJJA 


1AT 7"V 1 ^ T 

JJVAlj, 1 


n n zi 9 1 


1 fl 1 H A f, 
± U ± U t o 




LioK 


0 


n n 4 9 9 


n i n zi £ 7r 

U1U4D / JA 




AIM JJ 


DTI 

o / / 


n n a 9 9 
uu^z j 


n n 9 n n 9 




o Z.A, 


D C C 


n n zi 9 zi 


n 9 zi r n 9d 

UZ^DU jK 




0 MJr 




n n zi 9 r 

UU4ZO 


UDUUZZK 




CD 7A 
UJr A 


D 1 
J~5 1 


n n zi 9 £ 

UU4Z D 


n 9 zi r n 9d 

UZ^DU jK 




TMD 

0 MJr 


JaW 


n n zi 9 7 

UU4Z / 


n r n n 9 9r 

U 3 U U Z J>JA 




PDA 
UJr A 


D9 
dZ 


fl fl ZI 9 fl 
U U 4 o U 


fl 9 ZL R 9 0 D 
UZ^jjUK 




TMD 

J MJr 


DoKr 


00431 


050024R 




UJr A 


D 9 


00432 


024525R 




TMD 

J MJr 


I?QPP 


fl fl A ^ ^ 
U U H O O 


UJU4J / K 




UJr A 


DZ1 


00434 


024503R 




TMD 

J MJr 


DW 


00435 


050460R 




Ulr A 


D R 


00436 


024503R 




TMD 

J Mr 


KW 


00437 


050461R 




Ur A 


D £ 


00440 


024412R 




TMD 


T T C* C T 

Mtbl 


00441 


050462R 




Ur A 


Din 
rS 1 U 


00442 


024473R 




TMD 

J Mr 


TJ 1 /"ATI 1 

EUr 


00443 


050463R 




CPA 


B13 


00444 


024525R 




JMP 


FSRF 


00445 


050464R 




PD]\ 

Lr A 


b 1 4 


00446 


024530R 




JMP 


BSRF 


00447 


050465R 




CPA 


B2 6 


00450 


024503R 




JMP 


RW 


00451 


050466R 




CPA 


B27 


00452 


025072R 




JMP 


ABSF 


00453 


002401 


ZERR 


CLA, 


. RSS 


00454 


060233R 


ERROR 


LDA 


ILREQ 


00455 


170003X 




STA 


$DV16, I 


00456 
* 


025130R 




JMP 


DDCM2 


00457 


000004 


B4 


OCT 


4 


00460 


000005 


B5 


OCT 


5 



LOWER BYTE MASK 



SETUP 
GET <S> 
ZERO XLOG 

SAVE <S> OR NON <S> 
GET DYNAMIC STATUS 
DONE (B=ERROR CODE) 



GET 

SUBFUNCTION 

RESET CTU? 
YES, DO REWIND 
WRITE EOF? 
YES 

BACKSPACE 1 RECORD? 
YES 

FORWARD SPACE 1 RECORD? 
YES 

REWIND? 
YES 

REWIND? 
YES 

DYNAMIC STATUS? 
YES 

WRITE EOF IF NOT PREV. WRITTEN 
YES 

FORWARD SPACE 1 FILE? 
YES 

BACKSPACE 1 FILE? 
YES 

WRITE END OF DATA (EOD) ? 
YES 

LOCATE ABSOLUTE FILE IPRAM1? 
YES 

ZERO ERROR CODE 

ILL. REQ. DON'T DOWN/DO FLUSH 
SAVE ERROR CODE 
DEVICE COMPLETION 
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00461 


000006 


B6 


OCT 


6 




00462 


000010 


B10 


OCT 


10 




00463 


000013 


B13 


OCT 


13 




00464 


000014 


B14 


OCT 


14 




00465 


000026 


B26 


OCT 


26 




00466 


000027 


B27 


OCT 


27 




00467 


000077 


B77 


OCT 


77 




00470 


000200 


B200 


OCT 


200 




00471 


000320 


B320 


OCT 


320 




00472 
* 


007700 


B7700 


OCT 


7700 




* END 
* 


OF FILE 


(FUNCTION 


CODE = 10) 


* 


00473 


060232R 


EOF 


LDA 


S 


GET <S> IN UPPER BYTE 


00474 


171256R 




STA 


DVX12 , I 


SET TO SUCCESSFUL 


00475 


014662R 




JSB 


DYST 


GET DYNAMIC STATUS 


00476 


160001X 




LDA 


$DV6, I 


GET DEVICE STATUS 


00477 


010471R 




AND 


B320 




00500 


002002 




SZA 




AT EOF, LP, OR REWINDING? 


00501 


024453R 




JMP 


ZERR 


YES, DO NOT WRITE EOF 


00502 


002404 




CLA, 


, INA 


WRITE EOF 


* REWIND /WRITE EOF/WRITE EOD (FUNCTION CODE = 1,4,5 OR 26) * 


00503 


065216R 


RW 


LDB 


UO 


REWIND 


00504 


050022R 




CPA 


Bl 


WRITE EOF? 


00505 


065221R 




LDB 


U5 


YES 


00506 


050465R 




CPA 


B2 6 


WRITE EOD? 


00507 


065222R 




LDB 


U6 


YES 


00510 


175251R 




STB 


DVX7, I 


SAVE <u0 OR u5 OR u6> 


00511 


065217R 




LDB 


C 




00512 


175252R 




STB 


DVX8, I 


SAVE "C" 


00513 


064026R 




LDB 


M9 




00514 


174004X 




STB 


$DV17, I 


BUFFER LENGTH 


00515 


065246R 


SEND 


LDB 


DVX4 


GET ESCAPE SEQUENCE ADDR . 


00516 


174003X 




STB 


$DV16, I 


SAVE IT 


00517 


002404 




CLA, 


, INA 


ALLOW TIMEOUT 


00520 
* 


015155R 


SEND1 


JSB 


CEXIT 


INITIATE REQUEST 


00521 


014204R 




JSB 


STAT 


SETUP FOR 2 CHAR READ 


00522 


015155R 




JSB 


CEXIT 


SEND DC1, READ ' S' OR 'F' 


00523 


014662R 




JSB 


DYST 


GET DYNAMIC STATUS 


00524 


024202R 




JMP 


DONE 


DONE (B=ERROR CODE) 



* 



* FORWARD /BACKWARD SPACE N RECORD/FILE (FUNCTION CODE = 2,3,13 OR 14) * 

* 

00525 065224R FSRF LDB ONEP FORWARD SPACE ONE RECORD/FILE 

00526 014616R JSB FBRF SETUP ESCAPE SEQUENCE 

00527 024520R JMP SEND1 DO IT 
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00530 


065224R 


BSRF 


LDB 


ONEP 


00531 


014616R 




JSB 


FBRF 


00532 

* 


015155R 




JSB 


CEXIT 


00533 


014204R 




JSB 


STAT 


00534 


015155R 




JSB 


CEXIT 


00535 
* 


014662R 




JSB 


DYST 


00536 


160001X 




LDA 


$DV6, I 


00537 


011043R 




AND 


BIT4 


00540 


002002 




SZA 




00541 


024202R 




JMP 


DONE 


00542 


160001X 




LDA 


$DV6, I 


00543 


011044R 




AND 


BIT7 


00544 


002003 




SZA, 


RSS 


00545 


024571R 




JMP 


RECFL 


00546 


014642R 


BS2R 


JSB 


ASCWT 


00547 


065225R 




LDB 


TWOP 


00550 


060023R 




LDA 


B2 


00551 


014616R 




JSB 


FBRF 


00552 
* 


015155R 




JSB 


CEXIT 


00553 


014204R 




JSB 


STAT 


00554 


015155R 




JSB 


CEXIT 


00555 

* 


014662R 




JSB 


DYST 


00556 


160001X 




LDA 


$DV6, I 


00557 


011043R 




AND 


BIT4 


00560 


002002 




SZA 




00561 


024202R 




JMP 


DONE 


00562 


160001X 




LDA 


$DV6, I 


00563 


011044R 




AND 


BIT7 


00564 


002002 




SZA 




00565 


024202R 




JMP 


DONE 


00566 


014642R 




JSB 


ASCWT 


00567 


060024R 




LDA 


B3 


00570 
* 


024525R 




JMP 


FSRF 


00571 


161261R 


RECFL 


LDA 


DVX15, I 


00572 


010472R 




AND 


B7700 


00573 


050470R 




CPA 


B200 


00574 


024202R 




JMP 


DONE 


00575 


014642R 




JSB 


ASCWT 


00576 


065224R 




LDB 


ONEP 


00577 


060024R 




LDA 


B3 


00600 


014616R 




JSB 


FBRF 


00601 


015155R 




JSB 


CEXIT 



BACKSPACE ONE RECORD/FILE 
SETUP ESCAPE SEQUENCE 
DO IT 

SETUP FOR 2 CHAR READ 
SEND DC1, READ ' S' OR 'F' 
GET DYNAMIC STATUS 

GET STATUS 

GET LOAD POINT BIT 

AT LOAD POINT? 

YES, DONE (B=ERROR CODE) 

GET STATUS 

GET EOF BIT 

AT EOF? 

NO, CHECK FOR RECORD OR FILE 
ASCII WRITE (SYSTEM ADDR. SPACE) 

BACKSPACE TWO RECORDS 
SETUP ESCAPE SEQUENCE 
DO IT 

SETUP FOR 2 CHAR READ 
SEND DC1, READ ' S' OR 'F' 
GET DYNAMIC STATUS 

GET STATUS 

GET LOAD POINT BIT 

AT LOAD POINT? 

YES, DONE (B=ERROR CODE) 

GET STATUS 

GET EOF BIT 

AT EOF? 

YES, DONE (B=ERROR CODE) 

ASCII WRITE (SYSTEM ADDR. SPACE) 

FORWARD SPACE ONE RECORD 

DO IT 

GET INITIAL SUBFUNCTION 

BACKSPACE ONE RECORD? 

YES, DONE (B=ERROR CODE) 

ASCII WRITE (SYSTEM ADDR. SPACE) 

NO, THEN FORWARD SPACE 

ONE RECORD 
SETUP ESCAPE SEQUENCE 
DO IT 



3-16 Device Driver 



00602 


014204R 




JSB 


STAT 




SETUP FOR 2 CHAR READ 


00603 


015155R 




JSB 


CEXIT 




SEND DC1, READ ' S' OR 'F' 


00604 
* 


014662R 




JSB 


DYST 




GET DYNAMIC STATUS 


00605 


014642R 




JSB 


ASCWT 




ASCII WRITE (SYSTEM ADDR . SPACE) 


00606 


065224R 




LDB 


ONEP 




BACKSPACE ONE FILE 


00607 


0 604 64R 




LDA 


B14 






00610 


014616R 




JSB 


FBRF 




SETUP ESCAPE SEQUENCE 


00611 

* 


015155R 




JSB 


CEXIT 




DO IT 


00612 


014204R 




JSB 


STAT 




SETUP FOR 2 CHAR READ 


00613 


015155R 




JSB 


CEXIT 




SEND DC1, READ ' S' OR 'F' 


00614 

* 


014662R 




JSB 


DYST 




GET DYNAMIC STATUS 


00615 

* 


024546R 




JMP 


BS2R 




BACKSPACE TWO RECORDS 


00616 


000000 


FBRF 


NOP 






SPACE N RECORDS/FILES 


00617 


175252R 




STB 


DVX8, I 




SAVE <Np> 


00620 


065223R 




LDB 


UFRWD 






00621 


050023R 




CPA 


B2 




FORWARD SPACE? 


00622 


065227R 




LDB 


UBKWD 




NO, BACKSPACE 


00623 


050464R 




CPA 


B14 






00624 


065227R 




LDB 


UBKWD 




BACKSPACE 


00625 


175251R 




STB 


DVX7 , I 




SAVE <u+ OR u-> 


00626 


065226R 




LDB 


ONEC 






00627 


050463R 




CPA 


B13 




RECORD? 


00630 


065230R 




LDB 


TWOC 




NO, FILE 


00631 


050464R 




CPA 


B14 






00632 


065230R 




LDB 


TWOC 




FILE 


00633 


175253R 




STB 


DVX9, I 




SAVE <1C OR 2C> 


00634 


064657R 




LDB 


M12 






00635 


174004X 




STB 


$DV17, 


I 


BUFFER LENGTH 


00636 


065246R 




LDB 


DVX4 




GET ESCAPE SEQUENCE ADDR. 


00637 


174003X 




STB 


$DV16, I 


SAVE IT 


00640 


002404 




CLA, 


INA 




ALLOW TIMEOUT 


00641 

* 


124616R 




JMP 


FBRF, I 




RETURN 


* ASCII WRITE 


SUBROUTINE * 






00642 


000000 


ASCWT 


NOP 








00643 


161261R 




LDA 


DVX15, 


I 


GET SUBFUNCTION 


00644 


010661R 




AND 


RQASC 




CLEAR BITS 6,7,8 & RQ 


00645 


030660R 




IOR 


B602 




MAKE SURE ITS A ASCII WRITE 


00646 


010237R 




AND 


SBIT 




(SYSTEM ADDR. SPACE) 


00647 


170002X 




STA 


$DV15, 


I 


INHIBIT ' CRLF ' 


00650 


002400 




CLA 








00651 


170005X 




STA 


$DV18, 


I 


ZERO ASIC CONTROL WORD 


00652 


170006X 




STA 


$DV19, 


I 


ZERO OPTIONAL PARAMETER 


00653 


124642R 




JMP 


ASCWT, 


I 


RETURN 
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00654 


177773 


M5 


DEC 


-5 




00655 


177771 


M7 


DEC 


-7 




00656 


177770 


M8 


DEC 


-8 




00657 


177764 


M12 


DEC 


-12 




00660 


000602 


B602 


OCT 


602 


ASCII WRITE, INHIBIT ENQ-ACK FOR 


00661 


177074 


RQASC 


OCT 


177074 


ZERO BITS 6,7,8 & RQ 


* DYNAMIC STATUS (FUNCTION CODE = 
* 


6) * 


UUbuZ 


uuuuuu 


Dial 








n n £ £ 9 


UuUOOZK 




j_iJJ/\ 


n V Q T 
Dial 


STORE RETURN ADDRESS 


n n £ £ zl 


1 7 1 9 £ ID 




CTTj 
Oln 


n\7V9 1 T 
IJvAZl, 1 


AT DVX21 


UUDOj 


ni Zl £ ZL 9 1? 




TQD 




ASCII WRITE (SYSTEM ADDR. SPACE) 


n n £ £ £ 


U D1Z j / K 




t n a 


UJr 




n n f, £. 7 


1 7 1 9R1 D 
1 / 1Z OIK 




CTTj 
Oln 


D V A / r ± 


SAVE <"> 


U U O / U 


U D U 0 O OK 




t n a 


M7 


BUFFER LENGTH 


UU O 1 1 


i 7 n n n zl y 




CT7\ 
Oln 


C?n\7"1 7 T 
9 D V 1 / r 1 


SAVE IT 


n n f, 1 9 


D £ 1 9 ZL £R 




T HA 


D V A 4 


GET ESCAPE SEQUENCE ADDR. 


00673 


170003X 




STA 


$DV16, I 


SAVE IT 


00674 


002404 




CLA, 


INA 


ALLOW TIMEOUT 


UUD ' J 


fin R 1 R CD 

U J. D ± D Dr\ 




TCD 


^ Uj A 1 1 


SEND STATUS ESCAPE SEQUENCE 


00676 


160002X 




LDA 


$DV15, I 


MAKE SURE 


00677 


020024R 




XOR 


B3 


ITS A 


UU / UU 


1 / UUUZA 




C T A 
O 1 A 


9 D V 1 D r 1 


ASCII READ 


U U / U ± 


UOlZuZK 






D V A 1 O 


GET READ ADDR. 


U U / U z. 


1 / UUUja 




C T A 
O 1 A 


9 D V 1 u r 1 


SAVE IT 


UU / Uj 


UbUbooK 




T A 

LilJA 


JYLO 


BUFFER LENGTH 


U U / U 4 


l / U U U Hl a 




C T A 
O 1 A 


C; pa 7"1 7 T 
9 D V 1 / , 1 


SAVE I T 


UU / Uj 


UDU4U / K 




T TA A 


Pi C 1 


SETUP DC1 CODE 


U U / U 0 


1 / UUUOA 




C T A 
O 1 A 


9 D V 1 y , 1 


IN OPTIONAL PARAMETER 


u u / u / 


n n o a n n 
U Uz 4 UU 




CLA 






00710 


170005X 




STA 


$DV18, I 


ZERO ASIC CONTROL WORD 


00711 


002004 




INA 




ALLOW TIMEOUT 


00712 

* 


015155R 




JSB 


CEXIT 


SEND DC1, READ 8 BYTES STATUS 


00713 


160001X 




LDA 


$DV6, I 


GET DEVICE STATUS 


00714 


010411R 




AND 


LBYTE 


REMOVE OLD STATUS 


00715 

* 


170001X 




STA 


$DV6, I 




00716 


161264R 




LDA 


DVX18, I 


GET STATUS BYTES 0 & 1 


00717 


165265R 




LDB 


DVX19, I 


GET STATUS BYTE 2 


00720 


005700 




BLF 




MERGE THE 


00721 


100110 




RRL 


8 


THREE BYTES 


00722 


001700 




ALF 




TO FORM 


00723 


101110 




RRR 


8 


STATUS WORD 


00724 


011054R 




AND 


B7777 


REMOVE UPPER FOUR BITS 


00725 


170005X 




STA 


$DV18, I 


SAVE STATUS WORD 
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* EXAMINE STATUS * 

* 



00726 


064457R 


LDB 


B4 




00727 


010224R 


AND 


BIT6 




00730 


002002 


SZA 






00731 


015036R 


JSB 


DV6ER 




00732 


064462R 


LDB 


BIO 




00733 


160005X 


LDA 


$DV18, 


I 


00734 


010462R 


AND 


BIO 




00735 


002002 


SZA 






00736 


015036R 


JSB 


DV6ER 




00737 


064224R 


LDB 


BIT6 




00740 


160005X 


LDA 


$DV18, 


I 


00741 


011043R 


AND 


BIT4 




00742 


002002 


SZA 






00743 


015036R 


JSB 


DV6ER 




00744 


160005X 


LDA 


$DV18, 


I 


00745 


000010 


SLA 






00746 


024753R 


JMP 


CON 




00747 


160001X 


LDA 


$DV6, I 




00750 


030023R 


IOR 


B2 




00751 


011057R 


AND 


CBIT6 




00752 


170001X 


STA 


$DV6, I 




00753 


160005X CON 


LDA 


$DV18, 


I 


00754 


011052R 


AND 


B5002 




00755 


065044R 


LDB 


BIT7 




00756 


002002 


SZA 






00757 


015036R 


JSB 


DV6ER 




00760 


160005X 


LDA 


$DV18, 


I 


00761 


011050R 


AND 


B2000 




00762 


065043R 


LDB 


BIT4 




00763 


002002 


SZA 






00764 


015036R 


JSB 


DV6ER 




00765 


160005X 


LDA 


$DV18, 


I 


00766 


011047R 


AND 


B1002 




00767 


064406R 


LDB 


B40 




00770 


002002 


SZA 






00771 


015036R 


JSB 


DV6ER 




00772 


064023R 


LDB 


B2 




00773 


160005X 


LDA 


$DV18, 


I 


00774 


002011 


SLA, 


, RSS 




00775 


025014R 


JMP 


ERR 




00776 


064461R 


LDB 


B6 




00777 


031270R 


IOR 


=B17727 


01000 


002007 


INA, 


. SZA, RSS 


01001 


025014R 


JMP 


ERR 




01002 


064460R 


LDB 


B5 




01003 


160005X 


LDA 


$DV18, 


I 



SET BIT 2 

GET WRITE PROTECT BIT 
WRITE PROTECT? 
YES, SET 'WP' IN DV6 
SET BIT 3 
GET STATUS WORD 
GET SOFT ERROR BIT 
SOFT ERROR? 
YES, SET ' SE' IN DV6 
SET BIT 6 
GET STATUS WORD 
GET TAPE BUSY BIT 
TAPE BUSY? 

YES, SET 'DB' IN DV6 

GET STATUS WORD 

TAPE INSERTED? 

YES, CONTINUE 

GET DEVICE STATUS 

SET 'OF' IN DV6 

CLEAR 'DB' IN DV6 

SAVE NEW STATUS 

GET STATUS WORD 

GET EOF, EOT & EOV BITS 

SET BIT 7 

EOF, EOT, OR EOV? 

YES, SET 'EOF' IN DV6 

GET STATUS WORD 

GET LOAD POINT BIT 

SET BIT 4 

LOAD POINT? 

YES, SET 'BOM' IN DV6 

GET STATUS WORD 

GET EOT & EOV BITS 

SET BIT 5 

EOT OR EOV? 

YES, SET ' EOM' IN DV6 

NR ERROR MESSAGE 

GET STATUS WORD 

TAPE INSERTED? 

NO, SET 'NR' DV16=2 

WP ERROR MESSAGE 

WRITE PROT & WRITE ERR SET? 
YES, SET 'WP' DV16=6 
PE ERROR MESSAGE 
GET STATUS WORD 
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01004 


011045R 




AND 


B444 




01005 


002002 




SZA 




WRITE ERR, RD ERR OR HARD ERR? 


01006 


025014R 




JMP 


ERR 


YES, SET 'PE' DV16=5 


01007 


064457R 




LDB 


B4 


ET ERROR MESSAGE 


01010 


160005X 




LDA 


$DV18, I 


GET STATUS WORD 


01011 


011046R 




AND 


B1000 


GET EOT BIT 


01012 


002003 




SZA, 


. RSS 


EOT? 


01013 


006400 




CLB 




NO, SET DV16=0 


01014 


161256R 


ERR 


LDA 


DVX12, I 


GET ' S' , ' U' OR ' F ' 


01015 


002003 




SZA, 


, RSS 


ZERO LENGTH READ? 


01016 


025024R 




JMP 


ZLNRD 


YES, CHECK STATUS BITS 


01017 


010411R 




AND 


LBYTE 


REMOVE LOW BYTE 


01020 


050232R 




CPA 


S 


SUCCESSFUL? 


01021 


025031R 




JMP 


SUCCS 


YES 


01022 


051056R 




CPA 


U 


USER INTERRUPT? 


01023 


065055R 




LDB 


RTRY 


YES, RESTART 


01024 


160005X 


ZLNRD 


LDA 


$DV18, I 


GET STATUS 


01025 


011053R 




AND 


B7467 


MASK SFT ERR, WRT PROT , CMND EXECUT 


01026 


051051R 




CPA 


B4001 


EOF, TAPE INSERTED SET? 


01027 


006400 




CLB 




YES, ZERO ERROR CODE 


01030 


050024R 




CPA 


B3 


EOV, TAPE INSERTED SET? 


01031 


006400 


SUCCS 


CLB 




YES, ZERO ERROR CODE 


01032 


006002 




SZB 




ANY ERRORS? 


01033 


024202R 




JMP 


DONE 


YES, DONE (B=ERROR CODE) 


01034 


161267R 




LDA 


DVX21, I 


GET RETURN ADDRESS 


01035 
* 


124000 




JMP 


A, I 


RETURN 


01036 


000000 


DV6ER 


NOP 






01037 


160001X 




LDA 


$DV6, I 


GET DEVICE STATUS 


01040 


030001 




IOR 


B 


ADD STATUS BIT 


01041 


170001X 




STA 


$DV6, I 


SAVE NEW STATUS 


01042 
* 


125036R 




JMP 


DV6ER, I 


RETURN 


01043 


000020 


BIT4 


OCT 


20 


'BOM' BIT 


01044 


000200 


BIT7 


OCT 


200 


'EOF' BIT 


01045 


000444 


B444 


OCT 


444 


'WRITE ERR' , ' RD ERR' ,' HARD ERR' B 


01046 


001000 


B1000 


OCT 


1000 


'EOT' BIT 


01047 


001002 


B1002 


OCT 


1002 


'EOT', 'EOV BITS 


01050 


002000 


B2000 


OCT 


2000 


'LOAD POINT' BIT 


01051 


004001 


B4001 


OCT 


4001 


'EOF','TI' BITS 


01052 


005002 


B5002 


OCT 


5002 


' EOF' , ' EOT' , ' EOV BITS 


01053 


007467 


B7467 


OCT 


7467 


MASK ' SE' , ' WP' , ' CE' BITS 


01054 


007777 


B7777 


OCT 


7777 




01055 


100077 


RTRY 


OCT 


100077 


DON'T DOWN/DON'T FLUSH, RESTART 


01056 


052400 


U 


OCT 


52400 


' U' , USER INTERRUPT 


01057 


177677 


CBIT6 


OCT 


177677 


CLEAR BIT 6 



* FLUSH PORT BUFFERS FOR MUX (FUNCTION CODE 



26) 
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01060 


000000 


FPORT 


NOP 






01061 


161261R 




LDA 


DVX15, I 


SETUP SUBFUNCTION 


01062 


011070R 




AND 


SUBFN 


FLUSH PORT BUFFERS 


01063 


031071R 




IOR 


B2603 


FOR MUX. 


01064 


170002X 




STA 


$DV15, I 


SAVE IT 


01065 


002404 




CLA, 


INA 




01066 


170003X 




STA 


$DV16, I 


1ST PARAMETER = 1 


01067 

* 


125060R 




JMP 


FPORT, I 


RETURN 


01070 


170000 


SUBFN 


OCT 


170000 


CLEAR SUBFUN & RQ 


01071 
* 


002603 


B2603 


OCT 


2603 


CNTRL REQ. (FC=2 6B) 


* 

* LOCATE ABSOLUTE FILE IPRM1 (FUNCTION CODE =27) * 


n i o 7 9 

U 1 u / z. 


IuUUUjA 


ABSF 


LDA 


$DV16, I 


OJli 1 rlJDoU-LiU 1 JZj r J L— iJZj 


01073 


002020 




SSA 




NEGATIVE FILE #? 


■ i o 7 a i 


09 ci o o D 
JZOl jUJa 


JMP DDCM2 


IEjO r JJej V ILlj UUPIJr J_iI!j 1 rj 


01075 


065120R 




LDB 


M257 




U1U / D 


n a a n n n 

U *i *i u u u 




ADB 


A 




U1U / / 


n n f, n ? i 




SSB, 


RSS 


r J_ J_iJ1i ZOO 


m 1 nn 






JMP 


DDCM2 


IJliOf JJJli V ± UJ-J UUlYllT J_I-Cj 1 JZj 


U11U1 


UUZjUU 




CCE 




T — 1 ni?r , TM7AT VTT f ii 
Jli — _L r UK UJliU llYLrli-i r 1 -uHi ff 


(11109 


n i a n i i y 




JSB 


$CVT3 


r , mvn7F"RT FTT F it TO aQ^TT 
UUInVJIiKI r J l_i JcLi ff 1U iioL.ll 


0 110 9 






LDA 


UN 




U 1 1 U 4 






IOR 


$CVT+1 




01105 


171251R 




STA 


DVX7, I 


SAVE <uSPACE OR NUMBER> 


01106 


060012X 




LDA 


$CVT+2 




01107 


171252R 




STA 


DVX8, I 


SAVE FILE NUMBER 


OHIO 


061220R 




LDA 


P2 




01111 


171253R 




STA 


DVX9, I 


SAVE <p2> 


01112 


061217R 




LDA 


C 




01113 


171254R 




STA 


DVX10, I 


SAVE <C> 


01114 


061117R 




LDA 


M13 




01115 


170004X 




STA 


$DV17, I 


BUFFER LENGTH 


01116 


024515R 




JMP 


SEND 




01117 


177763 


M13 


DEC 


-13 




01120 

* 


177377 


M257 


DEC 


-257 




* 

01121 


161260R 


DDCOM 


LDA 


DVX14, I 


GET TOTAL XLOG (+CHARS) 


01122 


002004 




INA 




ROUNDOFF 


01123 


001100 




ARS 




CONVERT TO WORDS 


01124 


165255R 




LDB 


DVX11, I 


GET ORIGIONAL XLOG 


01125 


006020 




SSB 




WORDS? 


01126 


161260R 




LDA 


DVX14, I 


NO, SAVE CHAR'S 


01127 


170004X 




STA 


$DV17, I 


YES, SAVE WORDS 
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1130 


060003X DDCM2 


LDA 


$DV16 


1131 


065262R 


LDB 


DVX16 


1132 


014016X 


JSB 


.MVW 


1133 


000457R 


DEF 


B4 


1134 


000000 


NOP 




1135 


061241R 


LDA 


ESCB 


1136 


171246R 


STA 


DVX4, I 


1137 


014642R 


JSB 


ASCWT 


1140 


061246R 


LDA 


DVX4 


1141 


170003X 


STA 


$DV16, I 


1142 


060231R 


LDA 


M2 


1143 


170004X 


STA 


$DV17, I 


1144 


002404 


CLA, 


INA 


1145 


015155R 


JSB 


CEXIT 


1146 


061262R 


LDA 


DVX16 


1147 


064003X 


LDB 


$DV16 


1150 


014016X 


JSB 


. MVW 


1151 


000457R 


DEF 


B4 


1152 


000000 


NOP 





1153 002400 

1154 124000R 



CLA 

JMP DD . 2 0 , I 



ADDR OF INFO 
ADDR TO SAVE IT 

SAVE $DV16, $DV17, $DV18 & $DV19 
IN EXTENSION 

GET <ESCb> UNLOCK KEYBOARD 
SAVE IT 

ASCII WRITE (SYSTEM ADDR. SPACE) 

ESCAPE SEQUENCE ADDRESS 

SAVE IT 

BUFFER LENGTH 

SAVE IT 

ALLOW TIMEOUT 

INITIATE UNLOCK KEYBOARD 

ADDR OF INFO 

ADDR TO RESTORE IT 

RESTORE $DV16, $DV17, $DV18 & $DV19 
FROM EXTENSION 



DEVICE COMPLETE 



* CONTINUATION EXIT * 
0 



1155 


000000 CEXIT 


NOP 






1156 


065155R 


LDB 


CEXIT 


STORE RETURN ADDR 


1157 


175243R 


STB 


DVX1, I 


AT DVX1 


1160 


164003X 


LDB 


$DV16, I 


GET BUFFER ADDR 


1161 


175266R 


STB 


DVX2 0, I 


SAVE ADDR OF CURRENT 


1162 


034000R 


ISZ 


DD.2 0 




1163 


124000R 


JMP 


DD.2 0, I 


INTERFACE INITIATE 



* CONTINUATION * 



1164 


160003X 


CONT 


LDA 


$DV16, I 


GET ERROR CODE 


1165 


010467R 




AND 


B77 




1166 


165246R 




LDB 


DVX4 , I 


KEYBOARD JUST 


1167 


055241R 




CPB 


ESCB 


UNLOCKED? 


1170 


025173R 




JMP 


CONT2 


YES, DEVICE COMPLETE 


1171 


002002 




SZA 




ANY ERRORS? 


1172 


025130R 




JMP 


DDCM2 


YES, DEVICE COMPLETE 


1173 


165243R 


CONT2 


LDB 


DVX1, I 




1174 


124001 




JMP 


B, I 


CONTINUE REQUEST 



* ROUTINE FOR DEFINING STORAGE IN DEVICE DVR EXT. * 
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01175 


000000 


SETAD 


NOP 






01176 


160007X 




LDA 


$DV22, I 


GET ADDR POINTING TO ADDR 


01177 


051243R 




CPA 


DVX1 


EXTENSION SETUP? 


01200 


125175R 




JMP 


SETAD, I 


YES, RETURN 


01201 


065212R 




LDB 


D.21 


SET FOR 21 MISC. STORAGE 


01202 


075213R 




STB 


TEMP 




01203 


065242R 




LDB 


DVX 


SETUP 


01204 


170001 




STA 


B, I 


DVX1-DVX21 


01205 


002004 




INA 




ADDRESS 


01206 


006004 




INB 




POINTERS 


01207 


035213R 




ISZ 


TEMP 




01210 


025204R 




JMP 


*_4 




01211 

* 


125175R 




JMP 


SETAD, I 


RETURN 


01212 


177753 


D.21 


DEC 


-21 




01213 


000000 


TEMP 


NOP 




TEMPORARY STORAGE 



* ESC& 

* P1(P2) 

* U0 (U5) (U6) 

* C 



REWIND/WRITE EOF/WRITE EOD 
************************** 



01214 015446 ESC& 

01215 070061 PI 

01216 072460 U0 

01217 041400 C 

* 

01220 070062 P2 

01221 072465 U5 

01222 072466 U6 

* 



OCT 15446 
OCT 70061 
OCT 72460 
OCT 41400 

OCT 70062 
OCT 72465 
OCT 72466 



ESC& 
PI (P2) 

UFRWD (UBKWD) 
ONEP OR TWOP 
ONEC (TWOC) 



FORWARD /BACKWARD SPACE 
********************** 



<ESC&> 
<pl> 
<u0> 
<C> 

<p2> 
<u5> 
<u6> 

1 RECORD/FILE 
************** 



01223 072453 

01224 030560 

01225 031160 

01226 030503 



UFRWD OCT 72453 <u+> 

ONEP OCT 30560 <lp> 

TWOP OCT 31160 <2p> 

ONEC OCT 30503 <1C> 



01227 072455 

01230 031103 

* 



UBKWD OCT 72455 <u-> 
TWOC OCT 31103 <2C> 
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* FIND THE NTH FILE ON CTU (1 OR 2) 

* ESC& ********************************* 

* P1(P2) 

* UN 

* P2 

* C 

* 

01231 072400 UN OCT 72400 <u > 

* 

* WRITE N BYTES TO CTU (1 OR 2) 

* ESC& ***************************** 

* P1(P2) 

* DN 

* W 



01232 


062000 


DN OCT 


62000 


<d > 


01233 


053400 


W OCT 


53400 


<w> 


01234 

* 


002400 


ENQ OCT 


2400 


<ENQ> 


* 


READ 


FROM CTU ( 


1 OR 2) 


TO COMPUTER 


* ES' 


C& **** 


*********** 


******************* 


* pl 


(P2) 








* S2 










* R 

* 










01235 


071462 


S2 OCT 


71462 


<s2> 


01236 


051000 


R OCT 


51000 


<R> 



* FETCH STATUS OF CTU (1 OR 2) 

* ESC& **************************** 

* P1(P2) 

* UP 
* 

01237 057000 UP OCT 57000 <"> 
* 

* LOCK/UNLOCK KEYBOARD 

* ESCC ******************** 

* ESCB 

* 

01240 015543 ESCC OCT 15543 <ESCc> 

01241 015542 ESCB OCT 15542 <ESCb> 

* 

* EXTENSION FOR MISC. STORAGE * 
* 

01242 001243R DVX DEF DVX1 



01243 


000000 


DVX1 


NOP 


01244 


000000 


DVX 2 


NOP 


01245 


000000 


DVX3 


NOP 



CONTINUATION ADDR 

BUFF ADDR OF CURRENT REQUEST 

BUFF LENGTH (-CHAR'S) 



3-24 Device Driver 



01246 


000000 


DVX4 


NOP 


01247 


000000 


DVX5 


NOP 


01250 


000000 


DVX6 


NOP 


01251 


000000 


DVX7 


NOP 


01252 


000000 


DVX8 


NOP 


01253 


000000 


DVX9 


NOP 


01254 


000000 


DVX10 


NOP 


01255 


000000 


DVX11 


NOP 


01256 


000000 


DVX12 


NOP 


01257 


000000 


DVX13 


NOP 


01260 


000000 


DVX14 


NOP 


01261 


000000 


DVX15 


NOP 


01262 


000000 


DVX16 


NOP 


01263 


000000 


DVX17 


NOP 


01264 


000000 


DVX18 


NOP 


01265 


000000 


DVX19 


NOP 


01266 


000000 


DVX20 


NOP 


01267 


000000 


DVX21 


NOP 



* 



* DRIVER PARAMETER STORAGE * 

* 

* $DVTP CTU LEFT OR RIGHT 

* 

01270 177277 

END 



ESCc OR ESCb 

ESC& 

PI (P2) 

REMAINING 

CONTROL 

ESCAPE 

SEQUENCE 
INITIAL LENGTH 
ADDRESS OF ' S' OR 'F' 
REQUEST LENGTH (+CHARS) 
CHARACTER ACCUMULATOR 
INITIAL SUBFUNCTION 
BUFFER ADDR 

FOR 

1-8 

BYTE READ 
ADDR OF CURRENT READ 

CONTINUATION ADDR FOR DYNAMIC STATUS 



Volatile reference (store, jmp, call. 



$CVT 21 

$CVT3 21 

$DV1 21 

$DV15 20 

$DV16 2 0 

$DV17 20 

$DV18 2 0 

$DV19 2 0 

$DV22 20 

$DV6 20 

$DVTP 21 

$ONER 21 

$ONEW 21 

.MVW 21 

A 33 

ABSF 694 

ACK 219 



127 

125* 

318 

80 
320 

94 
268* 
694 

98 
249* 

560' 
152* 
579* 

620 
142* 
779 

87 
568 

77 
316* 
326* 
729* 
120 
376* 
159 



129 
702* 
328 
146* 
526* 
97* 
379* 

727 
134* 
256 

713' 
172* 
588 

628 
204* 

89* 
570* 



743* 
654* 



704 



166* 
554 
148* 
419* 

736* 
150* 
287* 

726* 
202* 
593 

633 
241* 

400 
600 



706 



200* 
556* 
168* 
515* 

742 
170* 
298 

738' 
251* 
597 

645 
292* 

442 
603* 



245* 
683* 
188* 
550* 

756 
176 
417* 

266* 
604 

529* 

446 
657 



260* 

193* 
558* 

765 
195* 
513* 

528* 
609 

562* 

460 
659* 



296 

247* 
685* 

233* 
548* 

564* 
614 



464 



698 
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ASCWT 521 

B 34 

Bl 62 

BIO 385 

BIOOO 665 

B1002 666 

B13 386 

B14 387 

B1415 334 

B2 63 

B200 391 

B2000 667 

B26 388 

B2603 689 

B27 389 

B3 64 

B320 392 

B4 382 

B40 332 

B4001 668 

B444 664 

B5 383 

B5002 669 

B6 384 

B602 536 

B7 65 

B7467 670 

B77 390 

B7700 393 

B7777 671 

BIT4 662 

BIT6 209 

BIT7 663 

BIT8 210 

BS2R 450 

BSRF 434 

C 805 

CBIT6 674 

CBIT7 211 

CEXIT 753 

CNTRL 350 

CON 604 

CONT 7 65 

CONT2 772 

CR.CR 218 

D. 21 792 

DC1 333 

DD.20 37 

DDCM2 727 

DDCOM 720 

DIREC 68 

DN 841 

DONE 188 

DV6ER 656 



82* 
734* 
279* 

53 
367 
634 
615 
369 
371 
250 

55 
474 
610 
373 
682 
375 

57 
469 
401 

48 
324 
647 
629 
363 
605 
365 
524 

41 
646 
352 
473 
578 
443 
243 
447 
165 
496* 
358* 
414 
602 
164 

49* 
238* 
454* 
566 

86* 
599* 

56* 
769* 
264 
782 
203 

19* 

50* 

59* 

38* 
126 
184* 
652* 
586* 



450* 468* 476* 

291 658 773* 

105 257 355 

587 589 



507 

488 503 509 
118 357 452 



411 



84 85 93 

478 555 649 

361 583 632 
616 



627 
623 

766 



461 594 611 
584 592 
465 606 



372' 
710 



136* 139* 154* 
253* 294* 421* 
457* 480* 483* 
740 754 



486* 

785* 
409 



530* 



544* 



501 601 619 



144 225 359 



730 744 



174* 179* 235* 
424* 436* 439* 
490* 493* 552* 



240 
748* 

58* 
189* 

40 

345* 
591* 



290 
758* 
380* 
314* 



426* 
596* 



561 
759* 
696* 
329* 



445* 
608* 



700' 



771' 



463* 467* 475* 
613* 618* 660* 
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DVX 87 0 

DVX1 871 

DVX10 880 

DVX11 881 

DVX12 882 

DVX13 8 83 

DVX14 8 84 

DVX15 8 85 

DVX16 88 6 

DVX17 8 87 

DVX18 888 

DVX19 88 9 

DVX 2 872 

DVX 2 0 8 90 

DVX21 8 91 

DVX3 873 

DVX 4 874 

DVX5 875 

DVX 6 876 

DVX 7 877 

DVX 8 87 8 

DVX 9 879 

DYST 541 

ECHO 212 

ENQ 843 

EOF 397 

ERR 637 

ERROR 37 8 

ESC& 802 

ESCB 866 

ESCC 865 

FBRF 4 98 

FPORT 67 9 

FSRF 430 

GO 53 

ILREQ 216 

INIT 73 

LBYTE 335 

Ml 331 

Mil 67 

M12 535 

M13 716 

M2 214 

M257 717 

M5 532 

M7 533 

M8 534 

M9 66 

ONEC 821 

ONEP 819 

PI 803 

P2 807 

PLU 213 

R 852 

RACK 142 



784 

755* 

711* 

9 9 * 
181 
282* 

47* 

81* 
196 

552 
147 
741 
270 
572 
573 

95* 
312 
543* 
104* 

74* 
767 

76* 

79* 
128* 
130* 
132* 
186* 
494* 

91 
141 
368* 
622* 
123* 

75 
732 

73 
431* 
138* 
227* 

43* 
378 

54* 

88 
302 
133 
512 
712 
194 
119 
248 
547 
559 
232 
506 
430 
Symbol 
708 

78 
230 
161* 



772 780 870 
723 

192 343* 398* 637 
301 

177* 185* 310* 342* 720 

83 90 92* 113 143 

242 259 317 327 350 
680 

157 246 261 269 557 



167 267 

757* 

653 

111 169 283 286 
96 418 514 549 



725 
163 
472 

728 



303 
733' 



705^ 



458* 



735 



229* 413* 505* 546* 

231* 415* 499* 707* 

511* 709* 

344* 399* 425* 440* 
542 



626* 631' 



768 

435* 453* 479* 489* 517' 

237* 686* 

360* 370* 470* 



158 182 319 569 640 
305 



307 737 
697 



484* 



416 



434 477 487 

not referenced 
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READ 225 

READ 5 241 

RECFL 472 

RQASC 537 

RS.CR 217 

RTRY 672 

RW 408 

S 215 

S2 851 

SBIT 220 

SEND 418 

SEND1 421 

SETAD 778 

STAT 191 

SUBFN 68 8 

SUCCS 650 

TEMP 7 93 

TICST 340 

TWOC 824 

TWOP 82 0 

U 673 

U0 804 

U5 808 

U6 809 

UBKWD 82 3 

UFRWD 818 

UN 833 

UP 85 9 

W 842 

WRITE Ill 

XLOG 308 

XEROL 342 

ZERR 377 

ZLNRD 645 



106* 
258* 
449* 
197 
262 
644 
354* 
183 
228 
145 
714* 
432* 
39* 
178* 
681 
642* 
315* 
366* 
508 
451 
643 
408 
410 
412 
502 
500 
703 
545 
131 
Symbol 
300* 
263* 
403* 
639* 



523 



356* 362* 364' 



374' 



340 397 



641 



199 244 525 



781* 790* 

206* 423* 438* 



325 783* 788' 
510 



456* 



482* 



492* 



504 

not referenced 
265* 278* 



/1000 Rev. 5000 870612 : No errors found 
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4 



Interface Driver 



The system enters the interface driver as indicated below. The address of the driver is picked up 
from the IFT. 

All pointers to the IFT, as described in the chapter on System I/O Tables, are set prior to 
entering the driver. The registers and calling sequence are (global register = select code and 
global register enabled): 

B -Register = DVT Address 

A-Register: Bits 2-0 = Entry Directive, as below: 

JSB ID.nn 
P+l done 
P+2wait 
P+3 resume 

Although not normally needed, the driver can determine the select code for the interface card by 
an LIA 2 instruction. 

The various entry directives and their codes in the A-Register are: 
Code Meaning 

000 Abort 

001 Initiate 

010 Continue 

011 Time Out 
100 Power Fail 
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The driver must increment its return address, stored at its entry point, to the proper exit as 
follows: 



Source Code 


Meaning 


A-Register on Exit 


JMP ID.XX,I 
P+l return 


Request complete 
on interface driver. 


QDOHT 


ISZ ID.XX 
JMP ID.XX,I 
P+2 return 


Wait for next 
interrupt or 
timeout. 


00IHT 


ISZ ID.XX 
ISZ ID.XX 
JMP ID.XX,I 
P+3 return 


Resume processing in 
the device driver. An 
interrupt has occurred 
from a device whose 
driver is not at the 
request list head (IFT3). 


000HT 



The P+3 return from the interface driver essentially means that the interface driver does not 
have enough information to completely process the interrupt. Therefore, it must call upon the 
device driver. 

Upon exit from the driver bits 0-4 of the A-Register are stored in the system flags area of IFT7. 
The meanings of the bits are: 



Q = Do not advance to next request on list. 

D = Defer entering device driver (pseudo done). 

I = Report illegal interrupt. 

H = Assert or maintain hold on new request initiation. 

T = Set timeout on device request. 
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Entry Directives 



The system will set up the pointers to the IFT before entering the driver. The system will also 
set up the pointers to the DVT if this is an "initiate" or "abort" entry. For other entry directives, 
the driver may set up pointers to the DVT by calling system routine $DIOC (as required). 

Upon entry, the directive code will be in the A-Register bits 2-0 and the DVT address will be in 
the B -Register. 

The global register for the select code given in the IFT is enabled prior to the entry of the 
interface driver by the system. The select code (if needed) can be found by reading the global 
register (LI A 2 instruction). 

Initiate New Request 

Upon entry, bits 2-0 of the A-Register equal 001. 

The purpose of this directive is to start a new request. The request code is in DVT15 with 
parameters in DVT16 through DVT19. 

The driver parameter area (starting at DVTP) and the driver communication area of DVT20 
may also contain useful information for processing the request. 

Unless the interface driver can complete the request immediately, it should make a "wait" exit 
after initializing the I/O operation. It should expect a "continue" entry to process the next 
interrupt, which will normally be a DMA completion. 

Continue Processing 

Upon entry, bits 2-0 of the A-Register equal 010. 

The purpose of this directive is to handle an interrupt, which usually will indicate DMA 
completion. The driver might chose to issue a new command which would lead to another 
interrupt or complete the request and take the "done" exit. 

Upon receiving this directive, the driver should immediately test and clear both flag 30 and flag 
23. The system itself takes no action on the flags. 

1. Flag 30 is the interface card flag and is cleared with a CLF 30. Either the interface flag or 
the DMA flag 21 may be used to indicate completion. 

2. Flag 23 is set if one or more of the following flags are set: 

Flag 20, indicating end of DMA chained list. 
Flag 21, indicating DMA completion. 
Flag 22, indicating a DMA parity error. 

A CLF 23 will clear flags 20, 21, and 22. 
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Timeout Processing 



Upon entry, bits 2-0 of the A-Register equal Oil. 

The interface driver is called for timeout when the working clock in IFT2 is incremented to zero. 

The working clock is initialized by the system upon every entry to the interface driver. It is set to 
the value taken from DVT13. 

The clock is used only if the interface driver sets the T bit in the A-Register upon exit. If it is 
enabled by this bit, then the clock starts ticking upon exit from the interface driver. 

Abort Request 

Upon entry, bits 2-0 of the A-Register equal 000. 

Prior to entering the driver (device or interface) the "A" bit in DVT7 is set to indicate that abort 
processing is in progress. It will be reset when abort processing is completed by the drivers. 

For requests which are busy, the device driver is given first chance at abort processing. If the 
device driver is entered and handles the request, then the interface driver will be called for abort 
processing only if the device driver makes an "initiate exit" with the abort request in the 
A-Register. 

If the user request specifies that the device driver is bypassed (bit 15 in the control word) or no 
device driver exists, then the system initiates the abort request on the interface driver. The 
system will also initiate this request if the device driver treats the abort request as an "illegal 
request." 

The intent of the abort request is to stop the operation on the I/O card as soon as possible. This 
may result in unpredictable device action. Therefore it is best if the action is initiated only upon 
the decision of the device driver. In any case, it is the responsibility of the interface driver to 
return the I/O card to a known state after completing the abort. 

When done with abort processing, the driver should take the "done" exit. 

Power-Fail Restart 

Upon entry, bits 2-0 of the A-Register equal 100. 

The interface driver will always be called upon power-fail restart. Hence every interface driver 
must be coded to accept such an entry directive (although it may choose to ignore it). 

The interface driver will always be called prior to the device driver when power-fail processing is 
to be done. The device driver will be called after the interface driver only if the P bit is set in 
DVT4. 
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Driver Exit 



Upon driver exit, there are three concerns: 

1. Setting of system flags through bits in the A- Register. 

2. Posting status in the DVT. 

3. Posting any errors, in addition to status. 

The system flags are set regardless of whether the exit is to indicate "done," "wait" or "resume". 
However, status and errors are posted only on the done exit. 

It is important to remember that the status of the transfer of data and any transfer errors should 
be posted by the interface driver. The device driver handles only device-dependent status and 
errors. 

The topics of status and error posting are common to both the device driver and the interface 
driver and so they are covered in a separate chapter of this manual. 

System Flags 

The three possible exit sequences from the interface driver are given below. For each exit, bits 
4-0 of the A- Register have the meaning indicated. The B -Register is meaningless. 

The system takes the contents of A- Register bits 4 through 0 and places them in the system flags 
area of IFT7. 



A-Register Bit: 


4 


3 


2 


1 


0 


P + 1 "Done" 


Q 


D 


0 


H 


T 


P + 2 "Wait" 


0 


0 


I 


H 


T 


P + 3 "Resume" 


0 


0 


0 


H 


T 



L88-334A 



T means set timeout. If set, the system will enter the interface driver in the timeout list. See 
Timeout Processing. 

H means hold. If set, the system will delay calling the interface driver to start a new request. It 
is recommended that the driver set this bit when it exits with DMA active for the user's buffer. 
This prevents the DMA port map register from being altered while DMA is in progress. 

If the hold is made on a "done" exit, a "continue" entry will be made to the device driver, 
just as if the hold was not made. This puts the IFT in a non-busy state in which the driver is 
waiting for expected interrupts. For example, the driver might be waiting for a response to a 
serial poll on the HPIB. When it comes, the interrupt causes a "continue" entry. The driver 
can easily identify the reason for the entry because the IFT is not busy. 
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I indicates an illegal interrupt. If set, the system will issue an error message of the form: 

Illegal interrupt from SC nn octal 

where nn is the select code on which the interrupt occurred. 

Q is request advance inhibit. If set, then the current DVT remains at the head of the request list 
on IFT3. Requests linked on other DVTs will be held off. (See Figure 2-1 for more on DVT/IFT 
linking.) Note that, even if the Q bit is zero, the request will remain at the head of the list if the 
IFT is locked to the DVT. 

D defers entry to device driver. If set, then the continue entry to the device driver will not be 
made; hence the request completion will be delayed. This is a "pseudo done" exit. 

If the driver sets the D bit, then it must keep track of the request and complete it later, if 
needed. The action taken by the system is simply to avoid the continue entry into the device 
driver. 

Normally, if D is set, then Q is not set, permitting advance to the next request. Thus, 
requests from multiple devices may be made on the interface driver before any are 
completed. This may be valuable if the requests take a long time to complete. 

The use of this bit implies timeout control by the interface driver. See the section on 
Asychronous I/O and Polling. 
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Sample Interface Driver 



This section contains a listing for a sample interface driver. Many of the features of the driver 
are not explained in detail in the manual because they are not essential to the structure of the 
driver. That is, there are many different ways the same result could be achieved and this listing 
represents one programmer's approach. 

Although this sample driver has been tested, it is not guaranteed to correspond to the code in 
any driver shipped with the system. It is included here only as an example. 



ASMB , R, L, C 

NAME: ID. 01 

SOURCE: 92077-18390 

RELOC: 92077-16390 

PGMR: T.A.L., B.A.C. 



* ******************************** 

* * (C) COPYRIGHT HEWLETT-PACKARD COMPANY 1982. ALL RIGHTS * 

* * RESERVED. NO PART OF THIS PROGRAM MAY BE PHOTOCOPIED, * 

* * REPRODUCED OR TRANSLATED TO ANOTHER PROGRAM LANGUAGE WITHOUT* 

* * THE PRIOR WRITTEN CONSENT OF HEWLETT-PACKARD COMPANY. * 

NAM ID. 01,0 92077-16390 REV. 2327 <881110 . 1042> 
ENT ID. 01 

EXT $IFTX, $DV15, $DV16, $DV17, $DV18, $DV19, $XQSB, $IF 

EXT $IF1, $IF5, $IF6, $DIOC, $LUTA, $DMPR, $ SELR, $DVTP 

GEN 1,PA 

GEN 10, EID . 01, TX: 33, IT: 01B 

000000 A EQU 0 

000001 B EQU 1 

00000 000000 ID. 01 NOP 

00001 010203R AND B7 *BC 

00002 071024R STA DIR *BC 

00003 002404 CLA, INA *BC 

00004 164012X LDB $IF5,I GET DVT ADDRESS *BC 

00005 014014X JSB $DIOC SET UP POINTERS *BC i 
* 

00006 0 64 00 IX LDB $IFTX GET INTERFACE DRIVER STORAGE ADDR 

00007 074777R STB DMAAD SAVE IT 

00010 044205R ADB D13 COMPUTE BREAK FLAG ADDR 

00011 075000R STB BRKFL SAVE IT 

00012 006004 INB COMPUTE PARITY CHECK FLAG ADDR 

00013 075001R STB PCHKB SAVE IT 

00014 006004 INB COMPUTE IGNORE INPUT FLAG ADDR 

00015 075002R STB IGNOR SAVE IT 

00016 006004 INB COMPUTE BIT BUCKET ADDR 

00017 075003R STB BITBK SAVE IT 
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/"\ /A /A *A /"\ 

00020 


/a /a t~ /a /a n 

006004 


INB 








*BC* 


/a /a /a *a 

00021 


075004R 


STB 


WDl 8A 


MODEM STATUS WORD ADDRESS 




*BC* 


r\ r\ i~\ »~i o 

00022 


r\ r\ r~ r\ r\ a 

006004 


INB 








*BC* 


n n n o o 

00023 


a t r a ri r "n 

0 7 5 0 0 5R 


STB 


r,7r\ 1 C\ ~7\ 

WDl 9 A 


TA T — " T" 1 TA A 7 TA T — " O T Tl\ — " "A TA TA TA T — " O O 

RETRY RESUME ADDRESS 




*BC* 


00024 


006004 


INB 








*BC* 


00025 


A T r A A /^Pi 

075006R 


STB 


r,Tr\ O A 7\ 

WD2 OA 


\ 




*BC* 


0002 6 


r\ t~\ r c\ r\ a 

006004 


INB 




\ 




*BC* 


ri n n o ^ 

00027 


c\ "~i r~ r\ r\ "~i ta 

075007R 


STB 


WD2 1A 


^ 1\ A /A TA T — " T\ A ~7\ T "A "T^l "K A TA TA /~\ f~~* TA "A "K R 1TT\ fi j!l — I 

> MODEM ALARM PROGRAM NAME 




*BC* 


/a r\ a\ o /a 

00030 


r\ r\ s~ r\ r\ n 

006004 


INB 




/ 




*BC* 


n n n o i 

00031 


075010R 


STB 


r,7r\ O O "A 

WD22A 


/ 




*BC* 


/a a\ a\ o o 

00032 


r\ r\ s~ r\ r\ a 

006004 


INB 








*BC* 


o /a o o o 

00033 


075011R 


STB 


WD23A 


LOGLU FOR ALARM PROG 




*BC* 


00034 


r\ r\ s~ r\ r\ n 

006004 


INB 








*BC* 


00035 


A 1 C A 1 On 

0 7 5 0 12R 


STB 


SAVEA 


T 1 T — " "K ATA "A TA T — ' O T 1 f~\ TA A T — ' 

TEMP A-REG STORAGE 




*BC* 


00036 


r\ r\ s~ r\ r\ n 

006004 


INB 








*BC* 


n a a i n 

00037 


075013R 


STB 


STSSS 


/~-\ TV TA TA 1^ T 1 7V T 1 T T f"l O til "A TA n n j^A r-p 

CARD STATUS SNAP SHOT 




*BC* 


O ia O /i O 

00040 


006004 


INB 








*BC* 


00041 


075014R 


STB 


RQ 


REQUEST WORD 




*BC* 


00042 


006004 


INB 








*BC* 


A A A /I T 

00043 


075015R 


STB 


Wl 8 






*BC* 


0 0 0 4 4 


r\ r\ r c\ c\ a 

006004 


INB 








*BC* 


00045 


075016R 


STB 


DIREC 


ENTRY DIRECTIVE 




*BC* 


00046 


006004 


INB 








*BC* 


00047 


075017R 


STB 


STRA 


TEMP STORAGE 




*BC* 


00050 


r\ r\ f r\ r\ a 

006004 


INB 








*BC* 


00051 


0 7 5 02 OR 


STB 


STRB 






*BC* 


00052 


006004 


INB 




IFTX WD31 


A. 


83BC 


00053 


075021R 


STB 


CRLFA 


MOVE CRLF CODE TO EXTENSION 


A. 


. 83BC 


00054 


0 607 4 OR 


LDA 


CRLFX 


~T ^ T /~1 "A O T — " TA TA ~T T TT — " TA T — " T 1 O "K A "A TA TA T — " TA /~\ T T T 1 

IN CASE DRIVER GETS MAPPED OUT 


A . 


. 83BC 


00055 


170001 


STA 


B, I 




A . 


. 83BC 


00056 


006004 


INB 




IFTX WD32 


A. 


. 83BC 


00057 


075022R 


STB 


ESCA 


MOVE ESCA CODE TO EXTENTION 


A. 


. 83BC 


00060 


0 6 0 7 4 1R 


LDA 


ESCX 


Tl\7 /~1 "A O T — I TA TA ~T T 71 — " TA f~"* T — " T 1 O HA7\ TA TA T — " TA /~\ T T T 1 

IN CASE DRIVER GETS MAPPED OUT 


A . 


. 83BC 


00061 


170001 


STA 


B, I 




A. 


. 83BC 


00062 


c\ c\ r c\ c\ a 

006004 


INB 




IFTX WD33 


A . 


. 83BC 


0 0 0 63 


075023R 


STB 


DC1A 


T\ ft /~\ T 71 — " TA "1 /~1 /~\ TA T — " T 1 /A T — " AT" T 1 T — " ^ T T" 1 ~T /A ^ T 

MOVE DC1 CODE TO EXTENTION 


A . 


. 83BC 


0 0 0 64 


C\ f~ C\ •"" 7 A O TA 

060742R 


LDA 


DC1X 


IN CASE DRIVER GETS MAPPED OUT 


A. 


. 83BC 


00065 
* 


170001 


STA 


B, I 




A. 


. 83BC 


0 0 0 6 6 


061024R 


LDA 


DIR 






*BC* 


0 0 0 67 


171016R 


STA 


DIREC, I 






*BC* 


00070 


102532 


LIA 


32B 


SAVE A SNAP SHOT OF CARD STATUS 




*BC* 


A A A T 1 

00071 


"1 T 1 O 1 O TA 

1710 1 3R 


STA 


STSSS , I 






*BC* 


00072 


160002X 


LDA 


$DV15, I 


SAVE REQUEST INFORMATION 




*BC* 


00073 


011703R 


AND 


=B7703 






*BC* 


00074 
* 


171014R 


STA 


RQ, I 


NOT VALID IF PF OR CONT ENTRY! 




*BC* 


00075 


161004R 


LDA 


WD18A, I 


GET MODEM CNTL WD 




*BC* 


00076 


002021 


SSA, 


RSS 


MODEM ENVIRONMENT? 




*BC* 


00077 

* 


024155 


JMP 


B. 1 


NO, GO AROUND 




*BC* 


* 
* 
* 


DO INPUT 


SCREENS . 











* ONCE ARMED FOR INCOMMING CALL, DON'T ALLOW ANY 

* DRIVER ENTRYS BUT CNTL32/31, PF, T/O OR CONTINUE 
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00100 


161004R 




LDA 


WD18A, I 




*BC* 


00101 


0 1 1 67 7R 




AND 


t> o a a a 

=B2 0 0 0 




*BC* 


00102 


r\ r\ i~i i~i **i 

002003 




SZA, 


RSS 


ARMED FOR AN INCOMMING CALL? 


*BC* 


00103 


02 4 1 52R 




JMP 


B . 0 1 


NO, NOT THE CASE. GO AROUND 


*BC* 


00104 


16101 6R 




LDA 


DIREC, I 


GET DRIVER ENTRY DIRECTIVE 


*BC* 


00105 


A r m 1 r -n 

050715R 




CPA 


B3 


T/O? 


*BC* 


00106 


024 152R 




JMP 


B . 0 1 


YES, ALLOW IT 


*BC* 


00107 


051657R 




CPA 


=B4 


PF ENTRY? 


*BC* 


00110 


024152R 




JMP 


B. 01 


YES, ALLOW IT 


*BC* 


00111 


051655R 




CPA 


=B2 


CONTINUATION ENTRY? 


*BC* 


00112 


A A A A A 1 

002001 




RSS 




YES, LOOK CLOSER 


*BC* 


00113 


024121R 




JMP 


B . 015 


NO , GO TO NEXT CHECK 


*BC* 


n A 1 1 A 

00114 


161013R 




LDA 


STSSS , I 




*BC* 


00115 


0 1 1 6 65R 




AND 


=B1 0 0 


DUE TO A MODEM STATUS CHANGE? 


*BC* 


00116 


A A A A A A 

002002 




SZA 






*BC* 


00117 


A A r 1 T r ri 

025135R 




JMP 


OL . 4 


NO, ARM AGAIN FOR DIAL-IN 


*BC* 


00120 


024152R 




JMP 


B . 0 1 


YES, ALLOW ENTRY 


*BC* 


00121 


161016R B 


.015 


LDA 


DIREC, I 




*BC* 


00122 


051654R 




CPA 


=B1 


INIT ENTRY? 


*BC* 


00123 


r\ r\ a a i 

0 02001 




RSS 




YES, LOOK CLOSER 


*BC* 


00124 


024132R 




JMP 


B. 016 


NO, FLUSH 


*BC* 


00125 


161014R 




LDA 


RQ, I 




*BC* 


00126 


051701R 




CPA 


=B3203 


CNTL 32? 


*BC* 


00127 


002001 




RSS 




YES 


*BC* 


00130 


051700R 




CPA 


=B3103 


CNTL 31? 


*BC* 


00131 
* 


024152R 




JMP 


B. 01 


YES, ALLOW IT 


*BC* 


* IB 


' THE USER 


HAS 


ACTIVATED THE 


BENIGN BIT AND FMGR 




* WAS ACTIVE ON A 


MODEM TERMINAI 


, THAT DISCONNECTED, 




* ITS AUTO PROMPT 


UPON RETURN WILL CAUSE ID. 01 TO DO 




* AND ENDLESS 

* 


STREAM OF FLUSHES 


UNTIL THE NEXT DIAL-IN. 




* 

00132 


060151R B 


.016 


LDA 


B17 


HOLD OFF NEXT FLUSH FOR 1.5 SEC 


*BC* 


00133 


171005R 




STA 


WD19A, I 


SAVE RETURN ADDRESS 


*BC* 


00134 


161004R 




LDA 


WD18A, I 


RESET CNTR, SET RETRY BIT 


*BC* 


00135 


011731R 




AND 


=B177400 




*BC* 


00136 


031667R 




IOR 


=B200 




*BC* 


00137 


171004R 




STA 


WD18A, I 




*BC* 


00140 


061734R 




LDA 


=D-150 




*BC* 


00141 


025254R 




JMP 


WT.A 




*BC* 


00142 


161004R B 


.017 


LDA 


WD18A, I 


RESET RETRY BIT 


*BC* 


00143 


011731R 




AND 


=B177400 




*BC* 


00144 


171004R 




STA 


WD18A, I 




*BC* 


00145 


060200R 




LDA 


ABRTE 


FLUSH, DON'T DOWN DVT 


*BC* 


00146 


170003X 




STA 


$DV16, I 




*BC* 


00147 


002400 




CLA 






*BC* 


00150 


124000R 




JMP 


ID. 01, I 




*BC* 


00151 
* 


000142R B17 


DEF 


B. 017 






* 

00152 


060545R B 


.01 


LDA 


B2000 


IF IN MODEM ENVIRONMENT, CHANGE 


B2000 


USED 














00153 


031670R 




IOR 


=B240 


IN DMA READ QUAD TO B2240 


*BC* 


00154 


002001 




RSS 






*BC* 


00155 


061025R B 


. 1 


LDA 


B2K 


IF NOT, LEAVE AS B2000 


*BC* 
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00156 


070545R 




STA 


B2000 








*BC* 


00157 


161016R 




LDA 


DIREC, I 


RESTORE A REG 






*BC* 




.■^r -k ~k ~k — 




_ * — * - 


. k k k k k 


k k k k k k k k k k k k 




_ * — * 






.■^r ~k * 




-k — k- 






* _ * _ * 


_ * _ * 




00160 


0 642 0 OR 




LDB 


ABRTE 


DON'T DOWN/DO FLUSH, NO 


MESSAGE 




00161 


002003 




SZA, 


RSS 


ABORT? 








0 0162 


024725R 




JMP 


ABORT 


YES 












. -k — k — k 


— k — k- 








_ if 




00163 


050715R 




CPA 


B3 


TIMEOUT? 






*BC* 


00164 


024723R 




JMP 


TIMOT 


YES 






*BC* 


00165 


1 61 0 0 4R 




LDA 


WD1 oA, I 


IF NOT T/O ENTRY, 






*BC* 


00166 


0 1 1 7 3 1R 




AND 


=B17 7 4 0 0 


T— r t — " o t — " t 1 T— r t — " t 1 T— r a 7 ttut t 1 t — " T— r 

RESET RETRY COUNTER 






*BC* 


00167 


171004R 




STA 


WD18A, I 








*BC* 


00170 


161016R 




LDA 


DIREC, I 








*BC* 


* _ * _ * _ 




.k — k — k 


-k — k- 


.k — k — k — k — k — 


k— k—k— k—k— k—k— k—k— k—k— k— 




_ 




00171 


050201R 




CPA 


Bl 


INITIATE? 








00172 


024206R 




JMP 


INIT 


YES 








00173 


015433R 




JSB 


MSCNG 


PF OR MODEM FAIL? 








00174 


161016R 




LDA 


DIREC, I 


RESTORE DIRECTIVE 








00175 


050202R 




CPA 


B2 


CONTINUATION? 








00176 


024553R 




JMP 


CONT 


YES 








* POWERFAIL * 
















00177 
* 


024560R 




JMP 


PWRFL 


POWERFAIL 








00200 


140077 


ABRTE 


OCT 


140077 


ABORT ERROR CODE 








00201 


000001 


Bl 


OCT 


1 










00202 


000002 


B2 


OCT 


2 










00203 


000007 


B7 


OCT 


7 










00204 


003000 


B3000 


OCT 


3000 










00205 
* 


000015 


D13 


DEC 


13 










* 

* INITIATION * 
















00206 


002400 


INIT 


CLA 












00207 


171002R 




STA 


IGNOR, I 


ZERO IGNORE INPUT FLAG 








00210 


160002X 




LDA 


$DV15, I 


GET RQ 








00211 


010715R 




AND 


B3 










00212 


050715R 




CPA 


B3 


CONTROL REQUEST? 








00213 

* 


024472R 




JMP 


CNTRL 


YES 








* BUILD DEFAULT CONTROL 


WORD * 










00214 


160005X 




LDA 


$DV1 8 , I 


GET USER CONTROL WORD 








00215 
* 


011726R 




AND 


=B17 4 3 7 7 


r~7 t — i t— r f~\ /r ~r T 1 T— r t t r itt at T— i 

ZERO XMIT, RCV & CHLN B 


ITS 






00216 


165004R 




LDB 


WD I OA, I 


T T7 1 l\yi / — \ t — i T7 1 T\/T T7 1 ATT 7 T T~> /^TnTIN/TTT 1 ATT 

It MUUEM ENVIKUNMEN 1 






*BC * 


00217 


006020 




SSB 










*BC* 


00220 
* 


011732R 




AND 


=B177407 


FORCE BITS 3-7 TO ZERO 


ALSO 




*BC* 


00221 


164002X 




LDB 


$DV15, I 


GET SUBFUNCTION & RQ 








00222 


030466R 




IOR 


B1000 


SET XMIT, BIT 9 








00223 


004032 




SLB, 


RBL 


WRITE REQUEST? 








00224 


020204R 




XOR 


B3000 


NO, SET RCV, BIT 10 








00225 


005727 




BLF, 


BLF 


SHIFT BINARY-ASCII BIT 









4-10 Interface Driver 



00226 
* 


/a /a /" /a o r\ 

006020 




SSB 


BINARY? 




00227 


024236R 




JMP 


SET8 


YES 


00230 


1 64 02 OX 




LDB 


$DVTP , I 


GET TERMINAL CONFIGURATION WORD 


00231 


005200 




RBL 




GET ASCII BIT 


f~\ f~\ o o o 

00232 


ri r\ r r\ o /"i 

006020 




SSB 




8 BIT ASCII ENABLED? 


00233 


024236R 




JMP 


SET8 


YES 


00234 


i on a A 1 n 

1210 0 1R 




XOR 


PCHKB, I 


^ 7 ta ~r t 1 ~a o s~i ~r ~r i\ ta ta t — " ta ta /~\ ta s~i t t t — " s~i tt~ ~t ~h t 

7 BIT ASCII. ADD ERROR CHECKING 


00235 


024237R 




JMP 


SET7 


NO 


00236 
* 


0304 65R 


SET8 


IOR 


BIT8 




00237 


015546R 


SET7 


JSB 


MDINT 


INT IF MODEM CHANGES IF MDM EN 


00240 


170005X 




STA 


$DV18, I 


SAVE CARD CONTROL WORD 


00241 


160002X 




LDA 


$DV1 5 , I 


GET RQ 


00242 


164004X 




LDB 


$DV17 , I 


GET TRANSMISSION LOG 


00243 


000010 




SLA 




TA T — " ~A TA TA T — " /~\ T T T — " C ' H" 1 *~\ 

READ REQUEST? 


00244 
* 


024370R 




JMP 


READ 


YES 


* WRI' 


rE REQUEST * 








00245 


160002X 




LDA 


$DV1 5 , I 


CHECK FOR BINARY/ASCII 


0024 6 


010463R 




AND 


BIT6 




00247 


002003 




SZA, 


RSS 


ASCI I ? 


00250 


024262R 




JMP 


ASCI I 


YES 


00251 


006003 


BINRY 


SZB, 


RSS 


BINARY ZERO XLOG? 


00252 


024720R 




JMP 


ZLOG 


YES, INTERFACE COMPLETE 


00253 


014743R 




JSB 


QUAD 


ta r t ~r t ta ta "A t 1 "a /~\ ttt\ ta t* t /~\ f /~i ta t t — " F 

BUILD DATA QUAD, NO CRLF 


00254 


100002X 




DEF 


$DV1 5 , I 




00255 


071400 




OCT 


714 0 0 


TA T\ "A f~l /~\ ~h T T 1 TA /~\ ~T Y-.1 /~\ TA TA 

DMA CONTROL WORD 


00256 


100005X 




DEF 


$DV18, I 


CARD CONTROL WORD 


00257 


100003X 




DEF 


$DV16, I 


BUFFER ADDRESS 


00260 


100004X 




DEF 


$DV17, I 


BUFFER LENGTH 


00261 
* 


024342R 




JMP 


ID . 10 


SEND DATA 


00262 


160002X 


ASCII 


LDA 


$DV15, I 


GET SUBFUNCTION 


00263 


010467R 




AND 


BIT1 1 


GET ESC BACKARROW BIT 


00264 


002002 




SZA 




TA T — " TA T — " /~\ TA "K A T — " O /~1 TA "A f~l T 7* "A TA TA /~\ Y-.1 O 

PERFORM ESC BACKARROW? 


00265 

* 


024311R 




JMP 


ASBLK 


YES 


* CHARACTER MODE * 








00266 


160002X 




LDA 


$DV1 5 , I 


f~l T T T — " /~1 T^" T — " /~\ TA f /~1 TA T T — " F 

CHECK FOR CRLF 


00267 


010464R 




AND 


BIT7 




00270 


002002 




SZA 




ADD CRLF? 


00271 


024251R 




JMP 


BINRY 


NO 


00272 


006003 




SZB, 


RSS 


ASCII ZERO XLOG? 


00273 


024302R 




JMP 


CRLF1 


YES 


00274 


014743R 




JSB 


QUAD 


TA T T T T TA, TA, "A T 1 "A f~\ T T "A TA 

BUILD DATA QUAD 


00275 


100002X 




DEF 


$DV15, I 




00276 


171400 




OCT 


171400 


DMA CONTROL WORD 


00277 


100005X 




DEF 


$DV18, I 


ASIC CONTROL WORD 


00300 


100003X 




DEF 


$DV16, I 


BUFFER ADDRESS 


00301 
* 


100004X 




DEF 


$DV17, I 


BUFFER LENGTH 


00302 


014743R 


CRLF1 


JSB 


QUAD 


BUILD 'CRLF' QUAD 


00303 


001032R 




DEF 


ZERO 




00304 


071400 




OCT 


71400 


DMA CONTROL WORD 
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00305 


100005X 




DEF 


$DV1 8 , 


I 


00306 


001021R 




DEF 


CRLFA 




00307 


000460R 




DEF 


M2 




00310 


024342R 




JMP 


ID . IO 




* BLOCK MODE * 










00311 


006003 


ASBLK 


SZB, 


RSS 




00312 


024321R 




JMP 


CRLFQ 




00313 


014743R 




JSB 


QUAD 




00314 


100002X 




DEF 


$DV15, I 


00315 


171400 




OCT 


171400 




00316 


100005X 




DEF 


$DV18, 


I 


U U j I / 






DEF 


$DV16, I 


00320 
* 


100004X 




DEF 


$DV17, I 


00321 


160002X 


CRLFQ 


LDA 


$DV15, I 


00322 


010464R 




AND 


oil/ 




00323 


002002 




SZA 






00324 

* 


024334R 




JMP 


NULK 




00325 


014743R 




JSB 


y U AJJ 




00326 


001032R 




DEF 


ZERO 




00327 


071400 




OCT 


/ 1 4 U U 




00330 


100005X 




DEF 


$DV1 8 , 


I 


00331 


001021R 




DEF 


LKLr A 




00332 


000462R 




DEF 


M5 




00333 

* 


024342R 




JMP 


ID . IO 




00334 


014743R 


NOCR 


JSB 


QUAD 




00335 


001032R 




DEF 


ZERO 




00336 


071400 




OCT 


h i a n n 
/ 1 4 U U 




00337 


100005X 




DEF 


$DV1 8 , 


I 


00340 


001022R 




DEF 


.Cj O Ln 




00341 

* 


000461R 




DEF 


M3 




* 

* START DMA * 










00342 


002404 


ID . 10 


CIA, 


INA 




00343 


034000R 




ISZ 


ID. 01 




00344 


107721 


WDOUT 


CLC 


21B, C 




00345 


107723 




CLC 


23B, C 




00346 


171012R 




STA 


SAVEA, 


I 


*BC* 












00347 


102531 




LIA 


31B 




*BC* 












00350 


011671R 




AND 


=B377 




00351 


102631 




OTA 


31B 




00352 


161012R 




LDA 


SAVEA, 


I 


00353 


006400 










00354 


106624 




OTB 


24B 




00355 

* 


103730 




STC 


30B, C 




00356 


064001X 




LDB 


$IFTX 




00357 


006004 




INB 






00360 


106620 




OTB 


20B 




00361 


103720 




STC 


20B, C 




00362 


124000R 




JMP 


ID. 01, 


I 



ASIC CONTROL WORD 
CRLF ADDRESS 
BUFFER LENGTH 
SEND DATA 



ASCII ZERO XLOG? 
YES, OUTPUT CRLF 
BUILD DATA QUAD 

DMA CONTROL WORD 
ASIC CONTROL WORD 
BUFFER ADDRESS 
BUFFER LENGTH 

CHECK FOR 'CRLF' 

ADD CRLF? 
NO 

BUILD 'CRLF ESC DC1' QUAD 

DMA CONTROL WORD 
ASIC CONTROL WORD 
CRLF ADDRESS 
BUFFER LENGTH 
SEND DATA 

BUILD 'ESC DC1' QUAD 

DMA CONTROL WORD 
ASIC CONTROL WORD 
ESC ADDRESS 
BUFFER LENGTH 



ALLOW TIMEOUT 

SETUP FOR INTERFACE CONTINUE 
SUSPEND AND 

TERMINATE DMA OPERATION 

IF MODEM INT'S WERE ENABLED, DON'T CHN 
KEEP SAME DTR, RTS STATE IN CNTL REG 

*BC* 
*BC* 
*BC* 

CLEAR BREAK FLAG 
ENABLE BREAK 

GET QUAD 

STARTING ADDRESS 
START DMA 

INTERFACE COMPLETE/CONTINUE 
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* 

00363 


103730 


WAIT 


STC 


30B, C 


00364 


002404 




CLA, 


INA 


00365 


171000R 




STA 


BRKFL, I 


00366 


034000R 




ISZ 


ID . 0 1 


00367 


124000R 




JMP 


ID . 0 1 , I 


* REAE 


) REQUEST 








00370 


006003 


READ 


SZB, 


RSS 


00371 


024720R 




JMP 


ZLOG 


00372 


160006X 




LDA 


$DV1 9 , I 


00373 


010470R 




AND 


LBYTE 


00374 


002003 




SZA, 


RSS 


00375 


024411R 




JMP 


READB 


00376 


160005X 




LDA 


$DV18, I 


00377 


0 1 1 67 6R 




AND 


=B1377 


00400 


030466R 




IOR 


B1000 


00401 


015546R 




JSB 


MD INT 


00402 


070737R 




STA 


TEMP 


00403 


014743R 




JSB 


QUAD 


00404 


001032R 




DEF 


ZERO 


00405 


171400 




OCT 


171400 


00406 


000737R 




DEF 


TEMP 


00407 


0 0 0 0 0 6X 




DEF 


$DV1 9 


00410 


000457R 




DEF 


Ml 


00411 


1 /"AAA ("Tr 

160006X 


READB 


LDA 


$DV1 9 , I 


00412 


010471R 




AND 


HBYTE 


00413 


002003 




SZA, 


RSS 


00414 


024450R 




JMP 


READQ 


00415 


002021 




SSA, 


RSS 


00416 


003004 




CMA, 


INA 


00417 


002004 




INA 




00420 


171002R 




STA 


IGNOR, I 


00421 


014743R 




JSB 


QUAD 


00422 


100002X 




DEF 


$DV15, I 


00423 


171600 




OCT 


171600 


00424 


100005X 




DEF 


$DV1 8 , I 


00425 


100003X 




DEF 


$DV1 6 , I 


00426 


100004X 




DEF 


$DV17 , I 


00427 


161002R 




LDA 


IGNOR, I 


00430 


a r\ <~i r\ a i 

002003 




SZA, 


RSS 


00431 
* 


024441R 




JMP 


READ1 


00432 


014743R 




JSB 


QUAD 


00433 


10 0 0 02X 




DEF 


$DV15, I 


00434 


071000 




OCT 


71000 


00435 


100005X 




DEF 


$DV18, I 


00436 


100003X 




DEF 


$DV16, I 


00437 


101002R 




DEF 


IGNOR, I 


00440 
* 


024342R 




JMP 


ID . 10 


00441 


014743R 


READ1 


JSB 


QUAD 


00442 


001032R 




DEF 


ZERO 


00443 


071600 




OCT 


71600 


00444 


000545R 




DEF 


B2000 



ALLOW TIMEOUT 
SET BREAK FLAG 

INTERFACE CONTINUE 



ZERO XLOG? 

YES, INTERFACE COMPLETE 
GET OPTIONAL PARAMETER 
REMOVE LOWER BYTE 
HIBYTE > 0? 
NO, CHECK LOW BYTE 
GET ASIC CONTROL WORD 

REMOVE RCV & ECHO BITS *BC* 
SET XMIT BIT 

*BC* 

SAVE ASIC CONTROL WORD 
BUILD WRITE QUAD 

DMA CONTROL WORD 
CARD CONTROL WORD 
OPTIONAL PARAMETER ADDR 
BUFFER LENGTH 

GET OPTIONAL PARAMETER 

REMOVE HIGH BYTE 

LOW BYTE ZERO? 

YES, BUILD READ QUAD 

POSITIVE NUMBER? 

YES, MAKE NEGATIVE 

SUBTRACT ONE 

SAVE IN EXTENSION 

BUILD READ QUAD 

DMA CONTROL WORD 
CARD CONTROL WORD 
BUFFER ADDRESS 
BUFFER LENGTH 

GET NUMBER OF INTERRUPTS TO IGNORE 
ZERO? 

YES, READ ONE BYTE INTO BIT BUCKET 

BUILD BIT BUCKET QUAD 

DMA CONTROL WORD 
CARD CONTROL WORD 
BUFFER ADDRESS 
BUFFER LENGTH 
SEND DATA 

BUILD READ BYTE QUAD 
DMA CONTROL WORD 

ASIC CONTROL WORD (B2240 IF MDM) *BC* 



Interface Driver 4-13 



00445 


001003R 




DEF 


BITBK 


BIT BUCKET ADDRESS 




00446 


000457R 




DEF 


Ml 






00447 


024342R 




JMP 


ID. IO 


READ BYTE 




00450 


014743R 


READQ 


JSB 


QUAD 


BUILD READ QUAD 




00451 


1 0 0 0 02X 




DEF 


$DV15, I 






00452 


071600 




OCT 


71600 


DMA CONTROL WORD 




00453 


100005X 




DEF 


$DV1 8 , I 


CARD CONTROL WORD 




00454 


100003X 




DEF 


$DV1 6 , I 


BUFFER ADDRESS 




00455 


100004X 




DEF 


$DV17 , I 


BUFFER LENGTH 




00456 


024342R 




JMP 


ID . IO 


SEND DATA 




00457 


1 ^7 ^7 ^7 ^7 ^7 

17 7 7 7 7 


Ml 


OCT 


-1 






00460 


17777 6 


M2 


OCT 


-2 






00461 


177775 


M3 


OCT 


-3 






00462 


177773 


M5 


OCT 


-5 






00463 


000100 


BIT6 


OCT 


100 


BIT 6, "BINARY-ASCII" BIT 




00464 


000200 


BIT7 


OCT 


200 


BIT 7, "CRLF" BIT 




00465 


000400 


BIT8 


OCT 


400 


BIT 8, "CHLN" BIT 




00466 


001000 


B1000 


OCT 


10 0 0 


BIT 9, "XMIT" BIT 




00467 


004000 


BIT11 


OCT 


4 0 0 0 


BIT 11, ESC BIT 




00470 


177400 


LBYTE 


OCT 


177400 


LOWER BYTE MASK 




00471 
* 


000377 


HBYTE 


OCT 


377 


HIGH BYTE MASK 




* 

* CONTROL REQUEST 










00472 


160002X 


CNTRL 


LDA 


SDV15, I 


GET 




00473 


101046 




LSR 


6 


SUBFUNCTION 




00474 


010515R 




AND 


B7 7 






00475 


050512R 




CPA 


B 6 


DYNAMIC SIAIUSr 




00476 


024520R 




JMP 


DYNAM 


YES 




00477 


050514R 




CPA 


B4 3 


ENABLE/DISABLE ERROR CHECKING 




00500 


024522R 




JMP 


PCHK 


YES 




00501 


050513R 




CPA 


B2 3 


CONTROL ASYNCHRONOUS INT . ? 




00502 


024527R 




JMP 


CASYN 


YES 










_ * _ * _ 


_ x — x — k — k — k — k 


— k — k — k — k — k — k — k — k — k — k — k — k — k — k — k — k 




00503 


050516R 




CPA 


B31 


OPEN MODEM LINE? 


*BC* 


00504 


025033R 




JMP 


OLINE 


YES 


*BC* 


00505 


050517R 




CPA 


B32 


CLOSE MODEM LINE? 


*BC* 


00506 


025200R 




JMP 


CLINE 


YES 


*BC* 










_ x — k — k — k — k — k 


— X — X — X — X — X — X — X — X — X — X — X — X — X — X — X — X 




00507 


002400 


DONE 


CLA 


IGNOR 


REQUEST 




00510 


170003X 




STA 


$DV16, I 


CLEAR ERROR CODE 




00511 

* 


124000R 




JMP 


ID . 0 1 , I 


INTERFACE COMPLETION 




00512 


000006 


B6 


OCT 


6 






00513 


000023 


B23 


OCT 


23 






00514 


000043 


B43 


OCT 


43 






00515 


000077 


B77 


OCT 


77 






00516 


000031 


B31 


OCT 


31 




*BC* 


00517 

* 


000032 


B32 


OCT 


32 




*BC* 


* 

* DYNAMIC STATUS (FUNCTION CODE =6) 


* 




00520 


014641R 


DYNAM 


JSB 


STAT 


READ ASIC STATUS & OUTPUT CNTRL 


WRD 


00521 


024507R 




JMP 


DONE 


INTERFACE COMPLETE 
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* 
* 

* ENABLE /DISABLE ERROR 


(FUNCTION 


CODE = 43) * 


00522 


160003X PCHK 


LDA 


$DV16, I 


GET PARAMETER 


00523 


010526R 


AND 


PMASK 


MASK PARITY & FRAMING ERROR 


00524 


171001R 


STA 


PCHKB , I 


SAVE IN PARITY CHECK FLAG 


00525 
* 


024713R 


JMP 


IDCOM 


~T ^ T T 1 T — " T^l T — " "A /~1 T — " /~1 /~\ 1\ ATI T T — ' T" 1 T — ' 

INTERFACE COMPLETE 


00526 
* 


030000 PMASK 


OCT 


30000 


MASK PARITY & FRAMING ERROR BITS 


* 

* ENABLE ASYNCHRONOUS INTERRUPT 


(FUNCTION CODE = 23) * 


00527 


160003X CASYN 


LDA 


$DV16, I 


GET PARAMETER 


00530 


002002 


SZA 




ENABLE ASYNC INT . 


00531 


024547R 


JMP 


DASYN 


NO 


00532 


160012X 


LDA 


$IF5, I 


SAVE DVT RESUME ADDR. 


00533 
* 


170001X LU1 


STA 


$IFTX, I 


IN DVT EXTENSION. 


00534 


014743R EASYN 


JSB 


QUAD 


BUILD READ QUAD 


00535 


001032R 


DEF 


ZERO 




00536 


061600 


OCT 


61600 


DMA CNTRL WRD DO NOT WRITE RESIDUE! ! ! 


00537 


000545R 


DEF 


B2000 


ASIC CONTROL WORD (B2240 IF MDM) *BC* 


00540 


001003R 


DEF 


BITBK 


BIT BUCKET ADDRESS 


00541 


000457R 


DEF 


Ml 


1 BYTE 


00542 


002400 


CLA 




DISABLE TIMEOUT 


00543 


171003R 


STA 


Oil DSX f 1 


INITIALIZE BIT BUCKET 


00544 
* 


024344R 


JMP 


WDOUT 


SEND DATA 


00545 


002000 B2000 


OCT 


2000 


BIT 10, RCV 


00546 
* 


000022 DC2 


OCT 


22 


DC2 IN LOWER BYTE 


* 

* DISABLE ASYNCHRONOUS 


INTERRUPT 


(FUNCTION CODE = 23) * 


00547 


0 024 0 0 DASYN 


CLA 




l~7 T — i T^i /~\ V\ T XT' T~\ T — ' P T 7ft A] — ' 7\ T> T> 7^1 

ZERO DVT RESUME ADDR. 


00550 


170001X 


STA 


$IFTX, I 


IN DVT EXTENSION. 


00551 


170003X 


STA 


$DV16, I 


ZERO ERROR CODE 


00552 
* 


024705R 


JMP 


LUCHK 


CHECK FOR LU=1 


* 

* CONTINUATION * 

■A- 








00553 


102524 CONT 


LIA 


24B 




00554 


002003 


SZA, 


RSS 


FRONT PANEL INTERRUPT? 


00555 


024571R 


JMP 


CONT1 


1TA f~** /~\ ft. 7 T" 1 THITT T — ' 

NO, CONTINUE 


00556 


002400 


CLA 




YES, ZERO 


00557 
* 


102624 


OTA 


24B 


SELECT CODE 24 


00560 


164013X PWRFL 


LDB 


$IF6, I 


GET AVAILABILITY 


00561 


006021 


SSB, 


RSS 


BUSY? 


00562 


024701R 


JMP 


BRK 


NO, CHECK FOR ASYNC CONDITION 


00563 


060736R 


LDA 


BREAK 


DON'T DOWN/DON'T FLUSH, RESTART NO MESS 


00564 


170003X 


STA 


$DV16, I 


ERROR CODE 


00565 


107721 


CLC 


21B, C 


SUSPEND AND 


00566 


107723 


CLC 


23B, C 


TERMINATE DMA OPERATION 


00567 


014641R 


JSB 


STAT 


READ ASIC STATUS & OUTPUT CNTRL WRD 


00570 


024713R 


JMP 


IDCOM 


INTERFACE COMPLETE 
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■k 

00571 


102222 


C0NT1 


SFC 


22B 




DMA COMPLETION? 


00572 


024016X 




JMP 


$DMPR 




NO, MEMORY ERROR 


00573 


160013X 




LDA 


$IF6, I 




GET AVAILABILITY 


00574 


002020 




SSA 






BUSY? 


00575 


024 650R 




JMP 


TICST 




YES 


00576 


034000R 




ISZ 


ID. 01 




NO, SETUP FOR CONTINUE 


00577 


160001X 




LDA 


$IFTX, 


I 


GET DVT RESUME ADDR. 


00600 


r\ r\ i~\ r\ r\ i~\ 

002002 




SZA 






ASYNCHRONOUS INT. ENABLED? 


00601 


024 605R 




JMP 


CONT4 




YES 


00602 


015374R 




JSB 


CLC 




CLEAR INTERRUPT FLAG , STOP DMA 


00603 


060716R 




LDA 


B4 




REPORT AN ILLEGAL INTERRUPT 


00604 


124000R 




JMP 


ID . 01, I 


INTERFACE CONTINUE 


00529 


* 












00605 


170012X 


C0NT4 


STA 


$IF5, I 




SAVE DVT RESUME ADDR. 


00606 


165003R 




LDB 


BITBK, 


I 


CHECK IF BLOCK MODE ENABLED 


00607 


101050 




LSR 


8 




SHIFT TO LOWER BYTE 


00610 


05454 6R 




CPB 


DC2 




BLOCK MODE? 


00611 


024 614R 




JMP 


HOLD 




YES 


00612 


034000R 




ISZ 


ID. 01 




DEVICE RESUME 


00613 


024534R 




JMP 


EASYN 




ENABLE ASYNCHRONOUS INT . 


00614 


014743R 


HOLD 


JSB 


QUAD 




BUILD DC1 QUAD 


00615 


001032R 




DEF 


ZERO 






00616 


171400 




OCT 


171400 




DMA CONTROL WORD 


00617 


000466R 




DEF 


B1000 




ASIC CONTROL WORD 


0 0 620 


001023R 




DEF 


DC1A DC1 


ADDRESS 


0 0 621 


000457R 




DEF 


Ml 




1 BYTE 


00622 


014743R 




JSB 


QUAD 




BUILD READ QUAD 


00623 


001032R 




DEF 


ZERO 






00624 


171600 




OCT 


171600 




DMA CONTROL WORD 


00625 


000545R 




DEF 


B2000 




ASIC CONTROL WORD (B2240 IF MDM) 


00626 


001003R 




DEF 


BITBK 




BIT BUCKET ADDRESS 


00627 


000457R 




DEF 


Ml 




1 BYTE 


00630 


014743R 




JSB 


QUAD 




BUILD 'DC1' QUAD 


00631 


001032R 




DEF 


ZERO 






0 0 632 


071400 




OCT 


71400 




DMA CONTROL WORD 


00633 


000466R 




DEF 


B1000 




ASIC CONTROL WORD 


00634 


001023R 




DEF 


DC1A 




BUFFER ADDRESS 


00635 


000457R 




DEF 


Ml 




BUFFER LENGTH 


00636 


060715R 




LDA 


B3 




ASSERT HOLD & TIMEOUT 


0 0 637 


171003R 




STA 


BITBK, 


I 




0 0 640 


024344R 




JMP 


WDOUT 




SEND DATA 


* REAC 

* 


i ASIC STATUS 


* 








0 0 641 


000000 


STAT 


NOP 


READ 




ASIC STATUS & OUTPUT CNTRL WRD 


00642 


102531 




LIA 


31B 




READ OUTPUT CONTROL WORD 


0 0 643 


170006X 




STA 


SDV19, I 


SAVE I I 


00644 


102532 




LIA 


32B 




READ ASIC STATUS WORD 


00645 


131000R 




IOR 


BRKFL, 


I 


MERGE BREAK FLAG INTO STATUS 


00646 


170005X 




STA 


$DV18, 


I 


SAVE IT 


00647 
* 


124641R 




JMP 


STAT, I 




RETURN 


00650 


014641R 


TICST 


JSB 


STAT 




READ ASIC STATUS & OUTPUT CNTRL 


00651 


002020 




SSA 






VAL DATA BIT SET? 


00652 


024663R 




JMP 


TLOG 




YES, IGNOR ERROR BITS 
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00653 


001200 




RAL 








00654 


002020 




SSA 






BREAK BIT SET? 


00655 


024363R 




JMP 


WAIT 




YES, WAIT FOR DMA COMPLETION 


00656 


010735R 




AND 


EMASK 




f~l T T T — " f~l T7* T — " TA "A T\ ft ~T~ ~h T f~i TA "A TA ~T~ T" 1 \ 7 C /~\ T 7"T — " TA TA TTT\T 

CHECK FRAMING, PARITY & OVERRUN 


00657 


002003 




SZA, 


RSS 




ZERO? 


00660 


02 4 6 63R 




JMP 


TLOG 




"\ 7 T — " O AT s~\ 1 — I TA TA /~\ TA 

YES, NO ERROR 


00661 


0 64 7 1 7R 




LDB 


B5 




T /~\ r-r-i T-^i "A ^TO"K/r~T O O ~T /~\ ~h T T — " TA TA /~\ TA 

NO, TRANSMISSION ERROR 


00662 


02472 6R 




JMP 


TDMA 




T" 1 T — " TA T\ ft ~T~ ~h T "A T 1 T — " TA 1\ ft "A /~\ TA T — " TA "A T 1 ~T~ /~\ ~h T 

TERMINATE DMA OPERATION 


00663 


103123 


TLOG 


CLF 


23B 




T T — " "A TA T — " T "A O O C\ O *1 i~ OO 

CLEAR FLAGS 20, 21 & 22 


00664 


i /A r~ ^ 

102523 




LIA 


23B 




READ REMAINING CHARACTERS (NEG) 


00665 


1 64 0 0 4X 




LDB 


$DV17, 


I 


T — " T 1 TA T T T — " T — " T — " TA T T — " T\ T f~i T 1 T T 

GET BUFFER LENGTH 


00666 


006020 




SSB 






ARE THEY CHARACTERS? 


00667 


007005 




CMB, 


INB, RSS 


YES 


00670 


005000 




BLS 






MULTIPLY WORDS BY 2 


00671 


040001 




ADA 


B 




FIND ACTUAL CHARACTER COUNT (POS 


00672 


164004X 




LDB 


$DV17, 


I 


GET BUFFER LENGTH 


00673 


006021 




SSB, 


RSS 




ARE THEY CHARACTERS? 


00674 


A A 1 1 (A (A 

001100 




ARS 






T\ T /~\ TA ~T T 7 ~T~ TA T — " T T "A TA O TA \ 7 O 

NO, DIVIDE CHARS. BY 2 


00675 


006400 




CLB 








00676 


"1 •"" 7 C\ C\ C\ A \7 

170004X 




STA 


$DV17, 


I 


SAVE AS + CHARS OR + WORDS 


00677 


174003X 




STB 


$DV16, 


I 


SETUP ERROR CODE 


r\ a n a n 

00700 


024702R 




JMP 


ASYNC 




ENABLE ASYNCHRONOUS INTERRUPT 


00701 
* 


034000R 


BRK 


ISZ 


ID. 01 




EXIT WAIT FOR VALID REQUEST 


00702 


164001X 


ASYNC 


LDB 


$IFTX, 


I 


GET DVT RESUME ADDR 


00703 


006002 




SZB 






WAS ASYNCHRONOUS INT. ENABLED? 


00704 


024534R 




JMP 


EASYN 




YES, RE-ENABLE INTERRUPT 


00705 


160012X 


LUCHK 


LDA 


$IF5, I 






00706 


150015X 




CPA 


$LUTA, I 


LU=1? 


00707 


024533R 




JMP 


LU1 




YES, RE-ENABLE INTERRUPT 


00710 


002400 




CLA 









00711 


102631 




OTA 


31B 


DISABLE PE & OE INT'S 


00712 


107730 




CLC 


30B, C 


DISABLE BREAK 


00713 


002400 


IDCOM 


CLA 






00714 
* 


124000R 




JMP 


ID . 01, I 


INTERFACE COMPLETION 


00715 


000003 


B3 


OCT 


3 




00716 


000004 


B4 


OCT 


4 




00717 

* 


000005 


B5 


OCT 


5 * 




* ZERC 

* 


) TRANSMISSION 


LOG 


* 




00720 


174003X 


ZLOG 


STB 


$DV16, I 


ERROR CODE 


00721 


014641R 




JSB 


STAT 


READ ASIC STATUS & OUTPUT CNTRL 


00722 
* 


024702R 




JMP 


ASYNC 


ENABLE ASYNCHRONOUS INTERRUPT 


* 

* TIMEOUT * 










00723 


015401R 


TIMOT 


JSB 


WT15 


CHECK 2S RETRY SITUATION 


00724 


064715R 




LDB 


B3 


TIMEOUT ERROR. 


00725 


014641R 


ABORT 


JSB 


STAT 


READ ASIC STATUS & OUTPUT CNTRL 


00726 


174003X 


TDMA 


STB 


$DV16, I 


CREATE ERROR CODE 


00727 


006400 




CLB 






00730 


174004X 




STB 


$DV17, I 


ZERO TRANSMISSION LOG 


00731 


107721 




CLC 


21B, C 


SUSPEND AND 
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7723 
6632 



00732 10 

00733 10 

* NOTE: 

* 
* 

00734 024702R 



CLC 23B,C 
OTB 32B 



TERMINATE DMA OPERATION 
RESET ASIC CARD 



FOR FUTURE REFRENCE, >10 0 MS MUST BE ALLOWED BETWEEN 
A CARD RESET AND OUTPUT DMA (RESET DOESN'T COMPLETE FOR 
18 CYCLES) 



JMP ASYNC 



ENABLE ASYNCHRONOUS INTERRUPT 



00735 07 

00736 10 

00737 00 

00740 00 
A. 83BC 

00741 01 
A. 83BC 

00742 01 
A. 83BC 



0000 EMASK OCT 70000 

0 077 BREAK OCT 100077 

0000 TEMP NOP 

6412 CRLFX OCT 6412 

5537 ESCX OCT 15537 

0400 DC1X OCT 10400 



MASK FRAMING, PARITY & OVERRUN 

DON'T DOWN/DON'T FLUSH, RESTART NO MESS 

TEMPORARY STORAGE 

' CRLF ' 

' ESC 

' DC1' 



* BUILD 

* 

00743 0 

00744 1 

00745 0 

00746 0 

00747 0 

00750 1 

00751 0 

00752 1 

00753 0 

00754 0 

00755 0 

00756 0 

00757 0 

00760 1 

00761 0 

00762 0 

00763 1 

00764 1 



DATA QUAD * 



00000 
60743R 
64011X 
34743R 
14017X 
30743R 
34777R 
70777R 
14765R 
14765R 
14765R 
34743R 
06020 
24743R 
05000 
07004 
74777R 
24743R 



QUAD 



NOP 

LDA 

LDB 

ISZ 

JSB 

IOR 

ISZ 

STA 

JSB 

JSB 

JSB 

ISZ 

SSB 

JMP 

BLS 

CMB, 

STB 

JMP 



QUAD, I 

$IF1 

QUAD 

$ SELR 

QUAD, I 

DMAAD 

DMAAD, I 

NEXT 

NEXT 

NEXT 

QUAD 

QUAD, I 

INB 

DMAAD, I 
QUAD , I 



SET RELOCATION REGISTER 
MERGE RELOCATION REG. NUMBER 

DMA CONTROL WORD 
ASIC CONTROL WORD 
BUFFER ADDRESS 
BUFFER LENGTH 
FIX RETURN ADDRESS 
CHARACTERS? 
YES, QUAD COMPLETE 
NO, SAVE 
BUFFER LENGTH 
IN CHARACTERS 
QUAD COMPLETE 



00765 0 

00766 0 

00767 0 

00770 0 

00771 1 

00772 0 

00773 0 

00774 1 

00775 1 

00776 1 



00000 

34777R 

34743R 

64743R 

64001 

05275 

24771R 

64001 

74777R 

24765R 



NEXT NOP 

ISZ DMAAD 
ISZ QUAD 
LDB QUAD 
LDB B, I 

RBL, CLE, SLB, ERB 



JMP 
LDB 



STB DMAAD, I 
JMP NEXT, I 



00777 000000 

01000 000000 

01001 000000 

01002 000000 



DMAAD NOP 
BRKFL NOP 
PCHKB NOP 
IGNOR NOP 



DVT RESUME ADDR PTR 
BREAK FLAG 
PARITY CHECK FLAG 
IGNORE INPUT FLAG 
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01003 


r\ r\ r\ r\ r\ r\ 

0 0 0 0 0 0 


BITBK 


NOP 




BIT BUCKET 














— x — x — x — x 


— X — X — X — X — X — X — X — X — X — X — X — X — X — X — X — X — X 






01004 


r\ r\ r, d d d 

000000 


WD1 8 A 


NOP 




"K ft /~\ TA T — " "K /T O T 1 "A T 1 T T O r,"7 /~\ TA TA "A TA TA TA T — " O O T — " O 

MODEM STATUS WORD ADDRESSES 




*BC* 


01005 


r\ t~\ r\ t~\ r\ r\ 

000000 


WD1 9 A 


NOP 




TA T — " T 1 TA A 7 TA T — " O T Tl\ ft~\ — " "A TA TA TA T — " O O 

RETRY RESUME ADDRESS 




*BC* 


010 0 6 


r\ r\ r\ r\ r\ r\ 

000000 


WD2 OA 


NOP 




\ 




*BC* 


01007 


r\ r\ t~\ r\ r\ r\ 

0 0 0 0 0 0 


WD2 1A 


NOP 




^ 1\ A /~\ TA T — " 1\ ft "A T "A TA 1\ ft TA TA /~\ /~"* TA "A "K ft RTT\ fi ft~\ — " 

> MODEM ALARM PROGRAM NAME 




*BC* 


01010 


r\ r\ r\ r\ r\ r\ 

0 0 0 0 0 0 


WD22A 


NOP 




/ ADDRESSES 




*BC* 


01011 


r\ r\ r\ d d d 

0 00000 


WD2 3A 


NOP 




"A T "A TA "K ft TA TA /~\ f~i ~T /~\ f~~* T T T "A TA TA TA T — " O O 

ALARM PROG LOGLU ADDRESS 




*BC* 


01012 


r\ r\ r\ r\ r\ r\ 

0 0 0 0 0 0 


SAVE A 


NOP 








*BC* 


01013 


t~\ r\ t~\ r\ r\ r\ 

0 0 0 0 0 0 


STSSS 


NOP 




O T 1 "A T 1 T T O O ^ T "A TA (~1 TT /~\ T 1 "A TA TA TA T — " O O 

STATUS SNAP SHOT ADDRESS 




*BC* 


01014 


r\ r\ r\ r\ r\ r\ 

0 0 0 0 0 0 


RQ 


NOP 




REQUEST " " " 




*BC* 


01015 


r\ r\ r\ r\ r\ r\ 

0 0 0 0 0 0 


Wl 8 


NOP 




tvtfa in rr rr rr 

WD 18 




*BC* 


01016 


000000 


DIREC 


NOP 




ENTRY DIRECTIVE 




*BC* 


01017 


000000 


STRA 


NOP 




TEMP STORAGE 




*BC* 


01020 


r\ r\ r\ r\ r\ r\ 

0 0 0 0 0 0 


STRB 


NOP 








*BC* 


01021 


r\ r\ r\ r\ r\ r\ 

000000 


CRLFA 


NOP 






A 


83BC 


01022 


r\ r\ r\ r\ r\ r\ 

0 0 0 0 0 0 


ESCA 


NOP 






A 


83BC 


01023 


r\ r\ r\ r\ r\ r\ 

000000 


DC1A 


NOP 






A 


83BC 


* 














*BC* 


01024 


000000 


DIR 


NOP 








*BC* 


01025 


002000 


B2K 


OCT 


2000 






*BC* 


01026 


000000 


PARM1 


NOP 








*BC* 


01027 


000000 


PARM2 


NOP 








*BC* 


01030 


000000 


PARM3 


NOP 








*BC* 


01031 


000000 


PARM4 


OCT 


0 






*BC* 


01032 

* 


000000 


ZERO 


OCT 


0 


PARM5 (MUST STAY 0) 




*BC* 


* _ * _ * 






_ * _ * _ 










* _ * _ * 






_ * _ * _ 











* OLINE - OPEN A MODEM LINE (IF NOT ALREADY OPEN) 

* SUPPLY AN ALARM PROGRAM NAME 

* (OR ATTEMPT TO DEFAULT TO AN OLD ONE) 

* MAKE SURE RESULTING ALARM PROG IS REALLY THERE! 



01033 


161004R 


OLINE LDA 


WD18A, I 


DROP ALL BITS BUT 13 


*BC* 


01034 


011705R 


AND 


=B20000 


IN WD18 


*BC* 


01035 


171004R 


STA 


WD18A, I 




*BC* 


01036 


160003X 


LDA 


$DV16, I 


UPDATE BIT 8,9 FROM PARM1 


*BC* 


01037 


006400 


CLB 






*BC* 


01040 


011721R 


AND 


=B140000 


(BENIGN BIT, AUTO/MANUAL ANSWER) 


*BC* 


01041 


101046 


LSR 


6 




*BC* 


01042 


031711R 


IOR 


=B100000 


SET "MODEM ENVIRONMENT BIT" 


*BC* 


01043 


131004R 


IOR 


WD18A, I 




*BC* 


01044 
* 


171004R 


STA 


WD18A, I 




*BC* 


* IF 
* 


PROG NAME SUPPLIED, SAVE IN 


WD2 0-2 2, OTHERWISE LEAVE ALONE 




01045 


160004X 


LDA 


$DV17, I 




*BC* 


01046 


002003 


SZA, 


RSS 


NEW NAME SUPPLIED? 


*BC* 


01047 


025060R 


JMP 


OL.2 


NO, GO AROUND 


*BC* 


01050 


015604R 


JSB 


SPACE 




*BC* 


01051 


171006R 


STA 


WD20A, I 


YES, SAVE IT 


*BC* 


01052 


160005X 


LDA 


$DV18, I 




*BC* 


01053 


015604R 


JSB 


SPACE 


SUBSTITUTE SPACES FOR ANY 0'S 


*BC* 


01054 


171007R 


STA 


WD21A, I 




*BC* 


01055 


160006X 


LDA 


$DV19, I 




*BC* 


01056 


015604R 


JSB 


SPACE 




*BC* 
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01057 


171010R 




STA 


WD22A, I 




*BC* 


01060 


160003X 


OL . 


2 LDA 


$DV1 6 , I 


NO . SAVE LOGLU FOR ALARM PROG 


*BC* 


01061 


171011R 




STA 


WD23A, I 




*BC* 


010 62 


161004R 




LDA 


WD1 8A, I 


LINE ALREADY OPEN? 


*BC* 


010 63 


011705R 




AND 


=B2 0 0 0 0 




*BC* 


010 64 


r\ r\ o r\ r\ ^ 

002003 




SZA, 


RSS 




*BC* 


01065 
* 


02507 6R 




JMP 


OL . 2 5 


NO, GO AROUND 


*BC* 


01066 


161011R 




LDA 


WD23A, I 




*BC* 


010 67 


011702R 




AND 


=B4 0 0 0 




*BC* 


01070 


070001 




STA 


B 




*BC* 


01071 


161004R 




LDA 


WD18A, I 


YES, EXIT NOW UNLESS MANUAL 


*BC* 


01072 


011673R 




AND 


=B1000 


ANSWER OR WD23 BIT 11 SPECIFIED 


*BC* 


01073 


030001 




IOR 


B 




*BC* 


010 7 4 


t~\ t~\ o r\ t~\ o 

002003 




SZA, 


RSS 




*BC* 


01075 


024507R 




JMP 


DONE 


YES, LEAVE. 


*BC* 


01076 


161006R 


OL . 


2 5 LDA 


WD20A, I 


DID WE END UP WITH A NAME? 


*BC* 


01077 


t~\ r\ o t~\ t~\ o 

002003 




SZA, 


RSS 




*BC* 


0110 0 
* 


015163R 




JSB 


GVUP 


NO. GIVE UP? 


*BC* 


01101 


161004R 




LDA 


WD18A, I 




*BC* 


01102 


171012R 




STA 


SAVEA, I 


SAVE WD18 AS IT IS 


*BC* 


01103 


160012X 




LDA 


$IF5, I 


DVT RESUME ADDRESS 


*BC* 


01104 


170001X 




STA 


$IFTX, I 




*BC* 


01105 


015306R 




JSB 


SP 


SEE IF PROG IS REALLY THERE! 


*BC* 


01106 


161012R 




LDA 


SAVEA, I 


I GUESS IT WAS ! 


*BC* 


01107 


171004R 




STA 


WD18A, I 


RESTORE WD 18 THE WAY IT WAS 


*BC* 


OHIO 


171015R 


OL. 


3 STA 


W18, I 


SAVE WD 18 


*BC* 


* NOTE: BEFORE 


ENTERING AT OL . 3 


WD18A, I MUST BE IN A 




01111 


015177R 




JSB 


CL 


HANG UP PHONE LINE 


*BC* 


01112 


161015R 




LDA 


W18, I 


RESTORE WD18 


*BC* 


01113 


171004R 




STA 


WD18A, I 




*BC* 


01114 


010466R 




AND 


B1000 


BIT 9 SET? 


*BC* 


01115 


002002 




SZA 






*BC* 


01116 


025137R 




JMP 


OL.M 


YES, MANUAL CONNECT IN PROGRESS 


*BC* 


01117 

* 


161004R 




LDA 


WD18A, I 


NO, AUTOMATIC 


*BC* 


* PRIME CARD 


> FOR INTERRUPT UPON 


"INCOMING CALL" 




* WI 

* 


:thout a 


DMA READ 








01120 


011672R 




AND 


=B400 


PRSERVE ONLY BENIGN BIT 


*BC* 


01121 


031715R 




IOR 


=B102000 


SET BITS 15,10 


*BC* 


01122 


171004R 




STA 


WD18A, I 




*BC* 


01123 


061671R 




LDA 


=B377 




*BC* 


01124 


170005X 




STA 


$DV18, I 


SAVE CNTL WD USED 


*BC* 


01125 


102631 




OTA 


31B 


SEND CNTL WD TO 12005B 


*BC* 


* 












*BC* 


01126 


102532 




LIA 


32B 


TO AVOID A CONTINOUS LOOP DUE TO 


*BC* 


01127 


011674R 




AND 


=B1030 


HARDWARE PROBLEM, DON' T ARM FOR 


*BC* 


01130 


051674R 




CPA 


=B1030 


INTERRUPT IF STATUS ISN'T OK 


*BC* 


01131 


002001 




RSS 




ALL IS OK SO SKIP 


*BC* 


01132 


025420R 




JMP 


DIE 


SOMETHING IS WRONG, SO GIVE UP 


*BC* 


* 












*BC* 


01133 


103730 




STC 


30B, C 


ENABLE INTERRUPT ON CHANGE 


*BC* 


01134 


024507R 




JMP 


DONE 


EXIT 


*BC* 



4-20 Interface Driver 



01135 


161004R 


OL. 4 


LDA 


WD18A, I 






*BC* 


01136 
* 


025110R 




JMP 


OL . 3 






*BC* 


* MANUAL ANSWER 












01137 


161004R 


OL.M 


LDA 


WD 1 8A, I 


ri T — 1 rp t-^ -T- rp i 

SET BITS 


9,14 


*BC* 


01140 


011672R 




AND 


=B4 0 0 






*BC* 


01141 


031723R 




I OR 


=B1 4 1000 






*BC* 


01142 


171004R 




STA 


WD18A, I 






*BC* 


01143 


002400 




CLA 




ACTIVATE 


DTR, RTS , DISABLE INT' S 


*BC* 


01144 


170005X 




STA 


?DV1 a , I 






*BC* 


01145 


102631 




OTA 


3 IB 






*BC* 


01146 


002001 




RSS 




TRY ONCE 


BEFORE WAITING 


*BC* 


01147 


015240R 


OL.RT 


JSB 


WT2 S 


WAIT FOR 


2 SEC 


*BC* 


01150 


161013R 




LDA 


STSSS, I 


GET CARD 


STATUS 


*BC* 


01151 


011674R 




AND 


=B1030 


BITS 3,4, 


9 = 0? 


*BC* 


01152 


002002 




SZA 




CONNECTION COMPLETED? 


*BC* 


01153 


025147R 




JMP 


OL.RT 


NO, TRY AGAIN 


*BC* 


01154 


161004R 




LDA 


WD18A, I 


YES, RESET BITS 14,7,9 SET 13 


*BC* 


01155 


011714R 




AND 


=B100400 






*BC* 


01156 


031705R 




IOR 


=B20000 






*BC* 


01157 


171004R 




STA 


WD18A, I 






*BC* 


01160 


002400 




CLA 








*BC* 


01161 


171005R 




STA 


WD19A, I 


CLEAR RETRY RESUME ADDRESS 


*BC* 


01162 


024534R 




JMP 


EASYN 


ENABLE KEY STRIKE INTERRUPT 


*BC* 








_ * _ * _ 











* 



* SUBROUTINE GVUP IS CALLED IF HAVING TROUBLE SCEDULING THE 

* ALARM PROGRAM. GVUP CHECKS USER PARM1 BITS 14/13. IF SET, 

* RETURN. IF NOT, GIVE UP AND JUMP TO "DIE". 



01163 


000000 


GVUP 


NOP 






*BC* 


01164 


171017R 




STA 


STRA, I 


SAVE A 


*BC* 


01165 


161011R 




LDA 


WD23A, I 




*BC* 


01166 


011710R 




AND 


=B40000 


BENIGN BIT SET? 


*BC* 


01167 


002002 




SZA 






*BC* 


01170 


025175R 




JMP 


GV. 1 


YES, RETURN 


*BC* 


01171 


161011R 




LDA 


WD23A, I 


NO. 


*BC* 


01172 


011705R 




AND 


=B20000 




*BC* 


01173 


002003 




SZA, 


RSS 


BIT 13 SET? 


*BC* 


01174 


025420R 




JMP 


DIE 


NO, GIVE UP 


*BC* 


01175 


161017R 


GV. 1 


LDA 


STRA, I 


RESTORE A 


*BC* 


01176 


125163R 




JMP 


GVUP , I 


RETURN 


*BC* 








_ * _ * _ 









* CNTL 32, CLINE - CLOSE THE LINE 

* (DOESN'T ALTER A PREVIOUSLY STORED ALARM PROGRAM NAME) 

* 



01177 


000000 


CL 


NOP 




JSB ENTRY POINT 


*BC* 


01200 


161004R 


CLINE 


LDA 


WD18A, I 


GET MODEM CNTL WD 


*BC* 


01201 


002021 




SSA, 


RSS 


IGNORE IF NOT MODEM ENVIRONMENT 


*BC* 


01202 


024507R 




JMP 


DONE 




*BC* 


01203 


015625R 




JSB 


FC 


CHECK FOR FORCED CLEANUP 


*BC* 


01204 


015560R 




JSB 


C3X 


CHECK FOR CURRENT CONNECTION 


*BC* 


01205 


161004R 




LDA 


WD18A, I 




*BC* 


01206 


011717R 




AND 


=B110400 


RESET BITS 14,13,11,10,7-0 


*BC* 


01207 


031716R 




IOR 


=B110013 


SET BIT 12,15,3,1,0 


*BC* 


01210 


171004R 




STA 


WD18A, I 


ALLOW ONLY 8 SEC. 


*BC* 



Interface Driver 4-21 



01211 


015374R 




JSB 


CLC 




DISABLE INTERRUPTS, STOP 


* DROP DTR, 


RTS 


SIGNALS TO 


MODEM 


01212 


060715R 




LDA 


B3 




SET DTR, RTS OFF (OFF=l) 


01213 


170005X 




STA 


$DV18 


, I 




01214 


102631 




OTA 


31B 






01215 
* 


102532 




LIA 


32B 




GET FRESH STATUS 


01216 
* 


025221R 




JMP 


CL. 2 




TRY ONCE BEFORE WAITING 


* GIVE MODEM 8 


SEC. TOTAL 


TO 


COMPLETE DISCONNECT 


01217 
* 


015240R 


CL. 


1 JSB 


WT2S 




WAIT 2 SEC. 


01220 


161013R 




LDA 


STSSS 


, I 


GET 12005B STATUS REG. 


01221 


011675R 


CL. 


2 AND 


=B1070 


BITS 3,4,5, 9=1 ? 


01222 


051675R 




CPA 


=B1070 




01223 


002001 




RSS 






YES, SKIP 


01224 
* 


025217R 




JMP 


CL. 1 




NO, TRY AGAIN 


* 

01225 


002400 




CLA 






ZERO DVT RESUME ADDRESS, 


ADDRESS 












01226 


065177R 




LDB 


CL 




UNLESS ENTERED BY JSB 


01227 


006002 




SZB 








01230 


025236R 




JMP 


CL. 3 




YES, JUST RETURN 



01231 170001X 

01232 171005R 

01233 171004R 

01234 171006R 

01235 024507R 



STA $IFTX, I 
STA WD19A, I 
STA WD18A, I 
STA WD20A, I 
JMP DONE 



ERASE ALARM PROGRAM NAME 
NO ERROR- DONE EXIT 



'BC^ 



*BC* 
*BC* 
*BC* 
*BC* 

*BC* 



*BC* 

*BC* 
*BC* 
*BC* 
*BC* 
*BC* 



*BC* 
*BC* 
*BC* 
*BC* 
*BC* 
*BC* 
*BC* 
*BC* 



236 


071177R 


CL. 3 


STA 


CL 


ZERO RETURN 


ADDRESS 


237 


124001 




JMP 


B, I 


RETURN 




* _ * _ 






_ * _ * _ 








* _ * _ 






_ * _ * _ 




— k — k — k — k — k — k . 





*BC* 
*BC* 



SUBROUTINE WT2S 
2 SEC. 





TAKE A 


1240 


000000 


1241 


061240R 


1242 


171005R 



(MUST BE CALLED BY JSB, BUT DOESN'T RETURN) 
T/O DRIVER EXIT 



WT2S NOP 

LDA WT2S 
STA WD19A, I 



GET RESUME ADDRESS, SAVE IN WD19 



*BC 
*BC 
*BC 



IF RETRY CNTR=17 TAKE ERROR BRANCH, OTHERWISE CONTINUE 



1243 


161004R 


LDA 


WD18A, I 


GET MODEM CONTROL WD 


1244 


011661R 


AND 


=B17 


MASK FOR RETRY COUNTER 


1245 


051661R 


CPA 


=B17 


RETRY LIMIT REACHED? 


1246 


025262R 


JMP 


RTERR 


YES, BRANCH 



"BC 
"BC 
'BC 
^BC 



01247 161004R 

01250 031667R 

01251 171004R 



LDA WD18A, I 
IOR =B200 
STA WD18A, I 



SET BIT 7 "RETRY WAIT ACTIVE' 



"BC 
'BC 
k BC 



TAKE A 2 SEC. 
WITH INTERRUPTS 



T/O EXIT (HOLD OFF NEW REQUESTS) 
DISABLED 



4-22 Interface Driver 



01252 
* 


015374R 




JSB 


CLC 


DISABLE INTERRUPTS, STOP DMA 


*BC* 


01253 


061733R 




LDA 


=D-200 


SET T/O FOR 2 SEC 


*BC* 


01254 
* 


170010X 


WT.A 


STA 


$IF2, I 




*BC* 


01255 


060715R 




LDA 


B3 


T T /~\ T T> T T — " T-.1 T~~l T — " /~\ T T T — " O T" 1 O "~t-i / /-\ -n i i-t-i -p t j-i — i 

HOLD NEW REQUESTS, T/O ACTIVE 


*BC* 


01256 


034000R 




ISZ 


ID . 0 1 


TS1 TV T rr-i T-n \ r T rri 

WAIT EXIT 


*BC* 


01257 


006400 




CLB 


ZERO 


DVT16, EXIT 


*BC* 


01260 


174003X 




STB 


$DV1 6 , I 




*BC* 


01261 


124000R 




JMP 


ID . 01, I 


EXIT DRIVER (T/O) 


*BC* 


* RTERR - RETRY LIMIT 


EXCEEDED 


OCTAL 17 




01262 


161004R 


RTERR 


LDA 


WD18A, I 




*BC* 


01263 


011702R 




AND 


=B4 0 0 0 


IS REASON FOR ERROR 


*BC* 


01264 


002003 




SZA, 


RSS 


COULD NOT SCHEDULE ALARM PROG? 


*BC* 


01265 


025270R 




JMP 


RT . 1 




*BC* 


01266 


015163R 




JSB 


GVUP 


YES. GIVE UP? 


*BC* 


01267 
* 


025364R 




JMP 


SP . 3 


NO, RETURN TO SPROG 


*BC* 


01270 


065662R 


RT. 1 


LDB 


=B20 


CHECK BIT 14 


*BC* 


01271 


161004R 




LDA 


WD18A, I 




*BC* 


01272 


011710R 




AND 


=B40000 




*BC* 


01273 


051710R 




CPA 


=B40000 


CONNECT T/O? 


*BC* 


01274 


002001 




RSS 




YES, USE I £ OR ERROR CODE 


*BC* 


01275 


065663R 




LDB 


=B40 


NO, USE 2 FOR ERROR CODE 


*BC* 


* MERGE ERROR CODE (IN B) INTO 

■4c 


WD18 




01276 


161004R 




LDA 


WD18A, I 




*BC* 


01277 


011735R 




AND 


=B177600 


CLEAR RETRY CNTR TOO 


*BC* 


01300 


030001 




IOR 


B 




*BC* 


01301 
* 


171004R 




STA 


WD18A, I 




*BC* 


01302 


015306R 




JSB 


SP 


SCHEDULE ALARM PROGRAM 


*BC* 


* (WILL NOT 


RETURN IF 


DISCONNECT TIME OUT) 




01303 


161004R 




LDA 


WD18A, I 


SET FOR AUTO ANSWER REDIAL 


*BC* 


01304 


011727R 




AND 


=B176777 




*BC* 


01305 


025110R 




JMP 


OL. 3 




*BC* 








. * _ * _ 
















-k — k — k — k — 


k — k — k — k — k — k — k — k — k — k — k — k — k — k — k — k — k — k 





* 



* SUBROUTINE SPROG ENTRY - JMP SPROG (OR JSB SP) 

* SCHEDULE PROGRAM NAME CONTAINED IN WD20A-22A,I 

* 



01306 


000000 SP 


NOP 




WILL BE 0 UNLESS CAME FROM OLINE 


*BC* 


01307 


161006R SPROG 


LDA 


WD20A, I 


GET LETTER 1 OF PROG NAME 


*BC* 


01310 


002002 


SZA 




EMPTY? 


*BC* 


01311 


025314R 


JMP 


SP . 0 


NO, GO AROUND 


*BC* 


01312 


015163R 


JSB 


GVUP 


YES. GIVE UP? 


*BC* 


01313 
* 


125306R 


JMP 


SP, I 


NO, RETURN 


*BC* 


01314 


161004R SP.O 


LDA 


WD18A, I 


NO. SET SCHED ATTEMPT BIT 


*BC* 


01315 


031702R 


IOR 


=B4000 




*BC* 


01316 


171004R 


STA 


WD18A, I 




*BC* 


* SET UP PARAMETERS AND SCHED 


ALARM PROG 




01317 


102531 


LIA 


31B 


TURN OFF DTR 


*BC* 



Interface Driver 4-23 



n 1 ^\ n 

01320 


011656R 




AND 


=B3 




*BC* 


01321 


031656R 




IOR 


=B3 




*BC* 


01322 

* 


102631 




OTA 


31B 




*BC* 


01323 


065711R 




LDB 


=B100000 






01324 


161004R 




LDA 


WD1 8A, I 




*BC* 


01325 


Oil 672R 




AND 


=B4 0 0 


BENIGN ERR PROC . BIT SET? 


*BC* 


01326 


C\ C\ O C\ C\ o 

002 0 0 3 




SZA, 


RSS 




*BC* 


01327 


n n n n i 

0 02001 




RSS 




NO, DROP BIT 6 IN SCHED PARM 1 


*BC* 


01330 


065712R 




LDB 


=B100100 


YES, SET BIT 6 


*BC* 


01331 


075026R 




STB 


PARM1 




*BC* 


01332 


161004R 




LDA 


WD1 8A, I 


EXTRACT ERROR CODE 


*BC* 


01333 


0 1 1 6 6 6R 




AND 


=B1 60 


AND PUT IN PARM1 


*BC* 


01334 


n n ^ inn 

006400 




CLB 






*BC* 


01335 


101024 




ASR 


4 




*BC* 


01336 


031026R 




IOR 


PARM1 


SET UP ERROR WD 


*BC* 


01337 

* 


071026R 




STA 


PARM1 


STUFF IN PARM1 


*BC* 


01340 


1610 1 3R 




LDA 


STSSS , I 


GET CARD STATUS 


*BC* 


01341 


071027R 




STA 


PARM2 


STUFF INTO PARM2 


*BC* 


01342 


i /~ n n n \ r 

160001X 




LDA 


$IFTX, I 


GET DVT RESUME ADDRESS 


*BC* 


01343 


071030R 




STA 


PARM3 


STUFF PARM3 


*BC* 


01344 


161011R 




LDA 


WD23A, I 


GET ALARM PROG LOGLU 


*BC* 


01345 


011671R 




AND 


=B377 


MASK LOWER BITS 


-4- -4- 

*BC* 


01346 
* 


071031R 




STA 


PARM4 


STUFF PARM4 


*BC* 


01347 


014007X 




JSB 


$XQSB 


SCHEDULE ALARM PROGRAM 


*BC* 


01350 


101006R 




DEF 


WD20A, I 




*BC* 


01351 


001026R 




DEF 


PARM1 




*BC* 


01352 

* 


000000 




DEC 


0 




*BC* 


* ON RETURN 


A = - 


1 IF 


PROG NOT 


FOUND 




* 




A > 


0 IF 


PROG BUSY 




* 
* 




A = 


0 SUCCESSFUL 


SCHEDULE 




01353 


050457R 




CPA 


Ml 


PROG FOUND? 


*BC* 


01354 


002001 




RSS 




NO 


*BC* 


01355 


025360R 




JMP 


SP .25 


YES, GO AROUND 


*BC* 


01356 


015163R 




JSB 


GVUP 


GIVE UP? 


*BC* 


01357 
* 


025364R 




JMP 


SP . 3 


NO, RETURN 


*BC* 


01360 


002003 


SP . 25 


SZA, 


RSS 


SUCCESSFUL SCHEDULE? 


*BC* 


01361 


025364R 




JMP 


SP . 3 


YES 


*BC* 


01362 


015240R 




JSB 


WT2S 


NO, WAIT 2 SEC 


-4- r** -4- 

*BC* 


01363 
* 


025307R 




JMP 


SPROG 


TRY AGAIN 


*BC* 


01364 


161004R 


SP . 3 


LDA 


WD18A, I 




*BC* 


01365 


011725R 




AND 


=B173400 


RESET BITS 11,7, 6-0 


*BC* 


01366 


171004R 




STA 


WD18A, I 




*BC* 


01367 


061026R 




LDA 


PARM1 




*BC* 


01370 


011660R 




AND 


=B7 




*BC* 


01371 


051655R 




CPA 


=B2 


DISCONNECT T/O? 


*BC* 


01372 


025420R 




JMP 


DIE 


YES, HW PROBLEM. GIVE UP 


*BC* 


01373 


125306R 




JMP 


SP, I 


NO, EXIT 


*BC* 








_ * _ * _ 









* 



* 



4-24 Interface Driver 



* SUBROUTINE CLC DOES A CLC XX, C ON 30,21,23 

* DISABLE INTERRUPTS AND STOP DMA 

01374 000000 CLC NOP 

01375 107730 CLC 30B,C 

01376 107721 CLC 21B,C 

01377 107723 CLC 23B,C 
01400 125374R JMP CLC, I 



WT15 - INTERCEPT TIMEOUT RETRYS AND BRANCH ACCORDINGLY 



* 


ENTRY - 


JSB WT15 AFTER 


A T/O DRIVER ENTRY 


* 
* 


EXIT - 


EITHER AT P+l OR 


PRE-DEFINED RESUME ADDRESS 


01401 


000000 WT15 


NOP 






01402 


171012R 


STA 


SAVEA, I 


SAVE A REG 


01403 


161004R 


LDA 


WD18A, I 


GET MODEM CNTL 


01404 


011713R 


AND 


=B100200 


BIT 15,7 MODEM & RETRY ACTIVE? 


01405 


051713R 


CPA 


=B100200 




01406 


025411R 


JMP 


WT15A 


YES, EXIT AT RESUME ADDRESS IN 


01407 


161012R 


LDA 


SAVEA, I 


NO, RESTORE A REG & RETURN 


01410 
* 


125401R 


JMP 


WT15,I P+l 


EXIT 


01411 


165005R WT15A LDB 


WD19A, I 


GET RESUME ADDRESS 


01412 


161004R 


LDA 


WD18A, I 


BUMP COUNTER 


01413 


002004 


INA 






01414 


171004R 


STA 


WD18A, I 




01415 


006002 


SZB 




IF B=0 SOMETHINGS VERY WRONG, 


01416 


124001 


JMP 


B, I 


LEAVE AT RESUME EXIT 


01417 


102024 


HLT 


24B 




* 


— k — k — k — k — k — k — 






k — * — k — * — * — * — k — * — k — k — k — * — k — * — k — k . 


* 
* 








k—k—k—k—k—k—k—k—k—k—k—k—k—k—k—k 



*BC* 
*BC* 
*BC* 
*BC* 
*BC* 
)A, I 
*BC* 
*BC* 

*BC* 
*BC* 
*BC* 
*BC* 
iLT 
*BC* 
*BC* 



* SUBROUTINE DIE - DISABLE INTERRUPTS AND TAKE T/O ERROR 



EXIT (THE RESULTING ERR21 SIGNIFIES A PROBLEM 
SCHEDULING AN ALARM PROGRAM) 



01420 


015374R 


DIE 


JSB 


CLC 


DISABLE INTERRUPTS, STOP 


01421 


102531 




LIA 


31B 


DROP DTR ON CARD 


01422 


011656R 




AND 


=B3 


TO PREVENT DIAL IN 


01423 


031656R 




IOR 


=B3 




01424 


102631 




OTA 


31B 




01425 


002400 




CLA 






01426 


171004R 




STA 


WD18A, I 


CLEAR MODEM CNTL WD 


01427 


171005R 




STA 


WD19A, I 


RESUME ADDRESS 


* PUT ERROR 


CODE 


IN DVT16, FLUSH 


THE REQUEST 


01430 


065722R 




LDB 


=B140025 




01431 


174003X 




STB 


$DV16, I 


POST ERR21 STATUS 


01432 


124000R 




JMP 


ID . 01, I 


DONE EXIT (A=0) 








_ * _ * _ 







*BC* 
*BC* 
*BC* 
*BC* 
*BC* 
*BC* 
*BC* 
*BC* 

*BC* 
*BC* 
*BC* 
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SUBROUTINE MSCNG - CHECK FOR MODEM STATUS CHANGE 
ENTRY - JSB MSCNG (MAY OR MAY NOT RETURN) 



01433 


000000 


MSCNG 


NOP 






014 34 


1 6 1 0 0 4R 




LDA 


WD1 8A, I 


f~i T — " T 1 "K ft /~\ V\ T — " "K ft /~1 7*. T T 1 T r,Tr\ 

GET MODEM CNTL WD 


01435 


002021 




SSA, 


RSS 


MODEM ENVIRONMEN 


01436 
* 


125433R 




JMP 


MSCNG, I 


NO, RETURN 


01437 


161016R 




LDA 


DIREC, I 


YES 


01440 


050716R 




CPA 


B4 


POWER FAIL? 


01441 
* 


025542R 




JMP 


M. PF 


YES, BRANCH 


01442 


161013R 




LDA 


STSSS, I 


NO, GET 12005B STATUS 


01443 


011665R 




AND 


=B1 0 0 


MODEM STATUS CHANGE? (0) 


01444 


002002 




SZA 






01445 


125433R 




JMP 


MSCNG, I 


NO, RETURN 


* 

* MODEM STATUS CHANGE 
* 


INTERRUPT 


HAS OCCURED 


01446 


161004R 




LDA 


WD1 8A, I 




01447 


011677R 




AND 


=B2 0 0 0 


WERE WE ARMED 


U14oU 


U Uz U u j 




C771 

SZA, 


RSS 


FOR AN INCOMMING CALL? 


U 1 4 D 1 


n o c c n c 




JMP 


M. HIT 


NO , GO AROUND 


01452 


161013R 




LDA 


STSSS, I 


YES, GET STATUS 


01453 


011663R 




AND 


=B4 0 




01454 


002002 




SZA 




"INCOMING CALL"? (0) 


01455 
* 


025135R 




JMP 


OL . 4 


NO, HANG UP, RE-ARM 


01456 


102531 




LIA 


31B 


YES, ACTIVATE DTR, RS SIGNALS (0) 


01457 


011737R 




AND 


=B177774 




01460 


170005X 




STA 


$DV18, I 




01461 

* 


102631 




OTA 


31B 


SEND TO CARD 


01462 


161004R 




LDA 


WD1 8A, I 


SIGNAL "CONNECT IN PROGRESS" 


01463 


031710R 




IOR 


=B4 0 0 0 0 




01464 


011724R 




AND 


=B141600 


NO LONGER "ARMED FOR INCOMING CALL 


01465 

* 


171004R 




STA 


WD18A, I 




01466 


015240R 


M.RT 


JSB 


WT2S 


WAIT 2 SEC 


01467 


161013R 




LDA 


STSSS , I 


GET STATUS 


01470 


011663R 




AND 


— B4 U 


3 = 1 r 


01471 


002003 




SZA, 


RSS 




01472 


025466R 




JMP 


M.RT 


NO, WAIT SOME MORE 


01473 


161013R 




LDA 


STSSS, I 




01474 


011674R 




AND 


=B1030 




01475 


002002 




SZA 




3,4, 9=0? 


01476 
* 


025466R 




JMP 


M.RT 


NO, WAIT SOME MORE 


01477 


161004R 




LDA 


WD18A, I 


YES! DROP ALL BUT 15,8 


01500 


011714R 




AND 


=B100400 




01501 


031705R 




IOR 


=B20000 




01502 


171004R 




STA 


WD18A, I 





*BC* 
*BC* 
*BC* 
*BC* 

*BC* 
*BC* 
*BC* 

*BC* 
*BC* 
*BC* 
*BC* 



*BC* 
*BC* 
*BC* 
*BC* 

*BC* 
*BC* 
*BC* 
*BC* 
*BC* 

*BC* 
*BC* 
*BC* 
*BC* 

*BC* 
*BC* 

*BC* 

*BC* 
*BC* 
*BC* 
*BC* 

*BC* 
*BC* 
*BC* 
*BC* 
*BC* 

*BC* 
*BC* 
*BC* 
*BC* 
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01503 
* 


024534R 




JMP 


EASYN 


TAKE CNTL2 3 PATH 


*BC* 


01504 


001516R 


M . RED 


DEF 


M.RES 




*BC* 


* MUST BE A 

■k 


HIT OR LINE DISCONNECT! 






101UU4K 


M . ri 1 1 


LDA 


TrJT~\ 1 Q 7\ T 

WJJ 1 oA, 1 




*BC* 


01506 


011720R 




AND 


=B120400 


SET BIT 7, RESET RETRY CNTR 


*BC* 


01507 


031667R 




IOR 


=B200 




*BC* 


01510 


171004R 




STA 


WD18A, I 


SAVE IT 


*BC* 


01511 


015374R 




JSB 


CLC 


DISABLE INTERRUPTS, STOP DMA 


*BC* 


HI M 0 

Ul JlZ 


U b 1 0 U 4 K 




t n 7\ 


1Y1 . KHj JJ 


o£j 1 UJr k\£j o U1 v 1Hj /iJJJJKHj o o 


*BC* 


01513 


171005R 




STA 


WD19A, I 




*BC* 


01514 


061736R 




LDA 


=D-30 


SET UP 300MS T/O WAIT 


*BC* 


01515 
* 


025254R 




JMP 


WT . A 


DO IT (RESUME AT M.RES) 


*BC* 


01516 


161013R 


M.RES 


LDA 


STSSS, I 


NO MORE CHANCES, ALL OK YET? 


*BC* 


UlOl / 


UIIoojK 




A1MJJ 


—n> *± U 




*BC* 


01520 


002003 




SZA, 


RSS 


BIT 5 SET? 


*BC* 


01521 
* 


025533R 




JMP 


ERR3 


NO 


*BC* 


01522 


161013R 




LDA 


STSSS, I 


YES, SO FAR, SO GOOD 


*BC* 


01523 


011674R 




AND 


=B1030 


3,4, 9=0? 


*BC* 


01524 


002002 




SZA 






*BC* 


01525 


025533R 




JMP 


ERR3 


NO 


*BC* 


01526 


161004R 




LDA 


WD18A, I 


YES, ALL IS FORGIVEN 


*BC* 


01527 


011720R 




AND 


=B120400 


DROP BIT 7-0 


*BC* 


01530 


171004R 




STA 


WD18A, I 




*BC* 


01531 


103730 




STC 


30B, C 


RE-ENABLE INTERRUPTS 


*BC* 


01532 
* 


024560R 




JMP 


PWRFL 


RESTART REQUEST 


*BC* 


01533 


161004R 


ERR3 


LDA 


WD1 8A, I 


SET ERROR CODE 3 & BIT 13 


*BC* 


01534 


011714R 




AND 


=B100400 




*BC* 


01535 


031706R 




IOR 


=B20060 


CLEAR OTHERS 


*BC* 


01536 


171004R 


ERR31 


STA 


WD18A, I 




*BC* 


01537 


015306R 




JSB 


SP 


SCHEDULE ALARM PROGRAM, RESET 


*BC* 


01540 


161004R 




LDA 


WD18A, I 


USING OLD VALUES 


*BC* 


01541 
* 


025110R 




JMP 


OL. 3 




*BC* 


01542 


161004R 


M.PF 


LDA 


WD18A, I 


PUT ERROR CODE 4 IN WD18 


*BC* 


01543 


011714R 




AND 


=B100400 




*BC* 


01544 


031665R 




IOR 


=B100 




*BC* 


01545 


025536R 




JMP 


ERR31 




*BC* 








_ * _ * _ 


-k — k — k — k — k 












_ * _ * _ 


-k — k — k — k — k 






* SUBROUTINE MDINT - IF IN A MODEM ENVIRONMENT ADDS BITS 




* 7 
* 


& 5 TO 12005B 


CNTL WORD 






* AT 


1 ENTRY 


(JSB MDINT) 


A=CURRENT CNTL WD 




* AT 


1 EXIT 






A=CORRECT CNTL WD 




01546 


000000 


MDINT 


NOP 






*BC* 


01547 


171012R 




STA 


SAVEA, I 




*BC* 


01550 


161004R 




LDA 


WD18A, I 


GET MODEM CNTL WD 


*BC* 


01551 


002021 




SSA, 


RSS 


MODEM ENVIRONMENT? 


*BC* 


01552 


025556R 




JMP 


MD.EX 


NO, EXIT 


*BC* 


01553 


161012R 




LDA 


SAVEA, I 


YES 


*BC* 


01554 


031670R 




IOR 


=B240 


ADD BITS 7,5 


*BC* 
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01555 


171012R 


STA 


SAVE A, I 








*BC* 


01556 


161012R MD. 


EX LDA 


SAVEA, I 








*BC* 


01557 


125546R 


JMP 


MDINT, I 




RETURN 




*BC* 










*_ 








* 














*BC* 


* C3X IF ALREADY PRIMED FOR 


AUTO-ANSWER 




*BC* 




OR IF VALID CONNECTION 


HAS ALREADY BEEN 




*BC* 




ESTABLISHED AND CNTL 32/31 RQ COMES IN, 




*BC* 




SEND A 


"LINE LOSS" CODE 


TO ALARM PROG 




*BC* 






RESETTING THE LINE 






UlobU 


000000 C3X 


NOP 










*BC* 


U 1 5 b I 


161016R 


LDA 


DIREC, I 




UNLESS THIS IS AN INITIATE 


*BC* 


fll c ^ o 
U 1 5 bZ 


051654R 


CPA 


=B1 




ENTRY, LEAVE 




*BC* 


U 1 5 bo 


002001 


RSS 










*BC* 


U 1 5 b4 


125560R 


JMP 


C3X, I 




IT ISN'T, LEAVE 




*BC* 


U 1 5 05 


161004R 


LDA 


WD18A, I 








*BC* 


01566 


011705R 


AND 


t~> o r\ r\ r\ r\ 

=B2 0 0 0 0 








*BC* 


01567 


002002 


SZA 






VALID CONN ALREADY ESTABLISHED? 


*BC* 


01570 


025576R 


JMP 


C3X1 




YES 




*BC* 


01571 


161004R 


LDA 


WD18A, I 




NO, AUTO ARMED ? 




*BC* 


01572 


011677R 


AND 


=B2000 








*BC* 


01573 


051677R 


CPA 


=B2000 








*BC* 


01574 


002001 


RSS 






YES, KEEP GOING 




*BC* 


01575 


125560R 


JMP 


C3X, I 




NO, EXIT 




*BC* 


* 














*BC* 


01576 


161004R C3X1 LDA 


WD18A, I 




YES 




*BC* 


01577 


011720R 


AND 


=B120400 




PUT LINE LOSS ERROR 


CODE IN WD18 


*BC* 


01600 


031664R 


IOR 


=B60 








*BC* 


01601 


171004R 


STA 


WD18A, I 








*BC* 


01602 


015306R 


JSB 


SP 




SCHED ALARM PROG 




*BC* 


01603 

* 

* 


125560R 


JMP 


C3X, I 




EXIT 




*BC* 


* 








*_ 








* SUBROUTINE "SPACE" WILL CHECK 


THE TWO ASCII 






* CHARACTERS IN 


THE UPPER AND 


LOWER BYTE OF THE 






* A- 


-REGISTER. 


IF EITHER IS ZERO 


, SUBSTITUTE 






* A 
* 


SPACE. 














01604 


000000 SPACE NOP 


ENTRY 








*BC* 


01605 


171017R 


STA 


STRA, I 




SAVE A 




*BC* 


01606 


011671R 


AND 


=B377 


FIRST CHECK LOWER BYTE 


(MASK UPPER) 


*BC* 


01607 


002002 


SZA 






0? 




*BC* 


01610 

* 


025614R 


JMP 


SPA. 1 




NO, GO CHECK HIGH BYTE 


*BC* 


01611 


161017R 


LDA 


STRA, I 




FETCH WORD AGAIN 




*BC* 


01612 


031663R 


IOR 


=B40 




ADD ACSII "SPACE" 




*BC* 


01613 


171017R 


STA 


STRA, I 




SAVE IT 




*BC* 


01614 


161017R SPA 


. 1 LDA 


STRA, I 




FETCH WORD 




*BC* 


01615 


011731R 


AND 


=B177400 




MASK OFF LOWER BYTE 




*BC* 


01616 


002002 


SZA 






0? 




*BC* 


01617 
* 


025623R 


JMP 


SPA. 2 




NO, LEAVE 




*BC* 


01620 


161017R 


LDA 


STRA, I 




YES 




*BC* 


01621 


031705R 


IOR 


=B20000 




ADD AN ASCII "SPACE" 




*BC* 


01622 


171017R 


STA 


STRA, I 








*BC* 
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01623 161017R SPA. 2 LDA STRA, I 

01624 125604R JMP SPACE, I 



EXIT 



FC (FORCE CLEANUP) IF BENIGN BIT SET AND CNTL 32 

COMES IN WHILE: 

A) USER IS VALIDLY CONNECTED OR 

B) PORT IS PRIMED FOR AUTO-ANSWER 

.AND . 

CNTL 31 PRAM1 BIT 12=1 

FORCE BENIGN BIT LOW AND CAUSE ACTIVE 
PROGRAMS TO BE CLEANED UP BY ALARM PROG. 



1625 000000 FC 

1626 171012R 

1627 161011R 

1630 011704R 

1631 002002 

1632 025652R 

1633 161014R 

1634 051701R 

1635 002001 

1636 025652R 

1637 161004R 

1640 011672R 

1641 002003 

1642 025652R 

1643 161004R 

1644 011707R 

1645 002003 

1646 025652R 



NOP 

STA SAVEA, I 
LDA WD23A, I 
AND =B10000 
SZA 

JMP FC.EX 

LDA RQ, I 
CPA =B3203 
RSS 

JMP FC.EX 

LDA WD18A, I 
AND =B4 0 0 
SZA, RSS 
JMP FC.EX 

LDA WD18A, I 
AND =B22000 
SZA, RSS 
JMP FC.EX 



SAVE A-REG 
BIT 12 CLEAR? 
NO, EXIT 
YES . 

CNTL 32 REQUEST? 

NO, EXIT 

YES 

BIT 8 SET? 
NO, EXIT 

EITHER 13 OR 10 SET 
NO, EXIT 



1647 161004R 

1650 011730R 

1651 171004R 



LDA WD18A, I 
AND =B177377 
STA WD18A, I 



ALL TESTS PASSED SO 
DROP BENIGN BIT 



1652 161012R FC.EX LDA SAVEA, I RESTORE A-REG 

1653 125625R JMP FC, I 



INTERFACE STORAGE * 



* 
* 


WORD 


1 : 


DVT RESUME ADDRESS 




* 


WORD 


2 : 


DMA CONTROL WORD 


\ 


* 


WORD 


3: 


CARD CONTROL WORD 


\ 1ST 


* 


WORD 


4 : 


BUFFER ADDRESS 


/ 


* 
* 


WORD 


5: 


- BUFFER LENGTH (CHAR) 


/ 


* 


WORD 


6: 


DMA CW 


\ 



* 


WORD 


7 


CARD CW 


\ 


2ND QUAD 


* 


WORD 


8 


BUF ADDR 


/ 




* 
* 


WORD 


9 


BUF LENGTH 


/ 




* 


WORD 


10 


DMA CW 


\ 




* 


WORD 


11 


CARD CW 


\ 


3RD QUAD 


* 


WORD 


12 


BUF ADDR 


/ 




* 


WORD 


13 


BUF LENGTH 


/ 


BIT: MEANING 



* 




WORD 


14 


RRFAKFTAC 








* 




WORD 


15 


ERROR CHECKING 


FLAG 


15: 


* 




WORD 


16 


IGNORE INPUT 


FLAG 


14 : 


* 




WORD 


17 


BIT BUCKET 






13: 


* 


*BC* 


WORD 


18 


>>>>>>>>>>>>>>>>>>>>>>>>>>>> 12: 


* 


*BC* 


WORD 


19 


RETRY RESUME 


ADDRESS 


11 : 


* 


*BC* 


WORD 


20 


\ 






10 : 




*BC* 


WORD 


21 


> MODEM ALARM 


PROGRAM 


NAME 9 : 


* 


*BC* 


WORD 


22 


/ 






8 : 


* 


*BC* 


WORD 


23 


ALARM PROG LOGLU, R/D, 


FC, HU : 


* 


*BC* 


WORD 


24 


SAVE A 






7 : 


* 


*BC* 


WORD 


25 


STSSS 






6-4 : 




*BC* 


WORD 


26 


RQ 








* 


*BC* 


WORD 


27 


W18 






3-0 : 


* 


*BC* 


WORD 


28 


DIREC 








* 


*BC* 


WORD 


29 


STRA 








* 


*BC* 


WORD 


30 


STRB 








* 


A. 83 


WORD 


31 


' CRLF ' 








* 


A. 83 


WORD 


32 


' ESC 








* 


A. 83 


WORD 


33 


'DC1' 









MODEM ENVIRONMENT 
CONNECT IN PROGRESS 
CONNECTION ESTABLISHED 
DISCON. IN PROG 
ATTEMPTING PROG SCHED 
ARMED FOR INCOM CALL 
1/0 MAN/AUTO ANSWER 
BENIGN ERR PROCESSING 

RETRY WAIT ACTIVE 
NO ERR, CONN T/O (0-4) 
DISCON T/O, LINE LOSS,PF 
RETRY COUNTER 



01654 000001 

01655 000002 

01656 000003 

01657 000004 

01660 000007 

01661 000017 

01662 000020 

01663 000040 

01664 000060 

01665 000100 

01666 000160 

01667 000200 

01670 000240 

01671 000377 

01672 000400 

01673 001000 

01674 001030 

01675 001070 

01676 001377 

01677 002000 

01700 003103 

01701 003203 

01702 004000 

01703 007703 

01704 010000 

01705 020000 

01706 020060 

01707 022000 



4-30 Interface Driver 



01710 


040000 


01711 


10 0 0 0 0 


01712 


10 010 0 


01713 


10 0200 


01714 


100400 


01715 


102000 


01716 


110013 


01717 


110 4 0 0 


01720 


120400 


01721 


-i a c\ c\ c\ c\ 

140000 


01722 


140025 


01723 


141000 


01724 


141600 


01725 


173400 


01726 


174377 


01727 


17 6777 


01730 


177377 


01731 


177400 


01732 


177407 


01733 


177470 


01734 


177552 


01735 


177600 


01736 


177742 


01737 


177774 



END 



* - Volatile reference (store, jmp, call...) 



$DIOC . . . 


. . 19 


33* 














$DMPR . . . 


. . 19 


518* 














$DV15 . . . 


. . 18 


91 


203 


217 


235 


243 


251 258 


265 






272 


291 


297 


375 




386 402 


425 


$DV16 . . . 


. . 18 


152* 


254 


275 


294 


378 


389 405 


441* 






460 


470 


494* 


511* 


596* 620 630* 


730 






751 


937* 


1100* 










$DV17 . . . 


. . 18 


236 


255 


276 


295 


379 406 586 


591 






595* 


632* 


740 










$DV18 . . . 


. . 18 


210 


234* 


253 


274 


28 


1 293 305 


313 






354 


377 


388 


404 




569* 745 


798* 








820* 


875* 


1138* 








$DV19 . . . 


. . 18 


350 


363 


366 


566 


* 


748 




$DVTP . . . 


. . 19 


225 














$IF1 . . . . 


... 19 


656 














$IF2 . . . . 


... 18 


932* 














$IF5 . . . . 


... 19 


32 


473 


530 


* 604 




774 




$IF6 . . . . 


... 19 


507 


519 












$IFTX . . . 


. . 18 


35 


333 


474 


* 493 


* 


523 601 


775* 








896* 1009 










$LUTA . . . 


. . 19 


605 














$ SELR . . . 


. . 19 


658* 














$XQSB . . . 


. . 18 


1015* 














A 


... 24 


Symbol not 


referenced 








ABORT . . . 


. . 629 


168* 














ABRTE . . . 


. . 190 


151 


166 












ASBLK . . . 


. . 288 


261* 














ASCII . . . 


. . 258 


246* 














ASYNC . . . 


. . 601 


597* 


622* 


641 


* 









Interface Driver 4-31 



B . 

B. 01 . 
B. 015 
B. 016 
B. 017 
B. 1 . 
Bl . 
B1000 
B17 . 
B2 . 
B2000 
B23 . 
B2K . 
B3 . 

B3000 
B31 . 
B32 . 
B4 . 
B43 . 
B5 . 
B6 . 
B7 . 
B77 . 
BINRY 
BIT11 
BIT6 . 
BIT7 . 
BIT8 . 

BITBK 690 



. 25 


75* 


80* 


85* 


590 


678 






7 64 


903* 


959 1078 




.158 


109* 


112* 


114* 


122 * 


132* 


124 


117* 










140 


127* 










148 


155 










1 61 


97* 










191 


17 9 










417 


218 


35 6 


541 


553 


7 8 6 


155 


140 










1 92 


183 










4 8 6 


158 


162* 


3 9 6 


47 9 


547 


445 


432 










710 


161 










613 


111 


171 

934 


204 


205 


557 


194 


220 










4 4 8 


435 










4 4 9 


437 










614 


527 


1115 








4 4 6 


430 










615 


581 










444 


428 










193 


29 










447 


427 










248 


268* 










418 


259 










414 


244 










415 


266 


298 








416 


231 










690 


44* 


397 


480 


483* 


531 



681 



761* 



628 



874 



548 



558* 



BREAK 64 5 

BRK 599 

BRKFL 687 

C3X 1231 

C3X1 1246 

CASYN 47 0 

CL 859 

CL.l 883 

CL.2 886 

CL.3 902 

CLC 1051 

CLINE 860 

CNTRL 425 

CONT 501 

CONT1 517 

CONT4 530 

CRLF1 278 

CRLFA 7 05 

CRLFQ 2 97 

CRLFX 647 

D13 195 

DASYN 4 92 

DC1A 707 

DC1X 649 

DC2 487 

DIE 1090 

DIR 709 



510 
509 

38 
864 
1239 
433 
783 
889 
879 
895 
526 
438 
206 
184 
503 
525 
270 

73 
289 

74 

37 
472 

83 

84 
533 
805 

30 



341* 568 
1235* 1244* 1251* 



893 



902* 



870* 929 1055* 1090* 1170* 



282 



306 



* 542 554 



* 850* 1041* 

* 87 
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DIREC 702 

DMAAD 68 6 

DONE 44 0 

DYNAM 4 54 

EASYN 47 6 

EMASK 64 4 

ERR3 1192 

ERR31 1195 

ESCA 706 

ESCX 648 

FC 1298 

FC.EX 1324 

GV.l 851 

GVUP 841 

HBYTE 420 

HOLD 538 

ID. 01 27 



ID. 10 320 

IDCOM 610 

IGNOR 689 

INIT 201 

LBYTE 419 

LU1 474 

LUCHK 604 

M. HIT 1166 

M.PF 1200 

M . RED 1162 

M.RES 1176 

M.RT 1146 

Ml 410 

M2 411 

M3 412 

M5 413 

MD.EX 1221 

MDINT 1213 

MSCNG 110 9 

NEXT 674 

NOCR 310 

OL.2 751 

OL.25 768 

OL.3 779 

OL.4 810 

OL.M 815 

OL.RT 823 

OLINE 727 

PARM1 712 

PARM2 713 

PARM3 714 

PARM4 715 

PCHK 460 

PCHKB 688 

PMASK 4 65 

PWRFL 507 

QUAD 654 



66' 

36' 
455' 
429' 
536' 
578 
1179' 
1203' 

78' 

79 
863' 
1303' 
846' 
770' 
367 
534' 

17' 



88* 110 
1114 1232 

660* 661* 
766* 808* 

603* 834* 
1184* 

314 
1325* 

1308* 1313* 



124 

670* 
862* 

1160* 



163 

675* 
900* 



177 
682* 



182 



852* 



946* 



1318* 
978* 



* 154* 321* 
522* 528* 535 
1101* 



256 
463 
42 
180 
351 
606 
495 
1129 
1116 
1171 
1162 
1150 
364 
283 
315 
307 
1217 
233 
181 
662 
300 
742 
757 
811 
121 
788 
827 
436 
998 
1008 
1010 
1013 
431 
40 
461 
188 
250 



284' 
515' 
202' 



308' 
373' 



337* 

* 599* 

391* 

381 



1027* 



342* 343* 442* 
611* 935* 938* 



399' 
390 



407' 



1154* 
398 



481 



543 



549 



555 



1024 



357* 1222* 
1112* 1121* 



663' 



664' 



683' 



966* 1198* 
1134* 



1004 



1005^ 



1017 



1038 



* 
* 

* 229 

* 1190* 

271* 
374* 385' 
550* 655 



462' 



278* 
393' 
657* 



290* 
401^ 
659 



302* 310* 359* 
476* 538* 544^ 
665* 667* 671^ 
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676* 



677 



READ 34 8 

READ1 3 93 

READB 3 6 6 

READQ 4 01 

RQ 700 

RT.l 949 

RTERR 942 

SAVE A 6 98 

SET7 233 

SET8 231 

SP 974 

SP.O 981 

SP.25 1030 

SP.3 1035 

SPA.l 1271 

SPA. 2 1279 

SPACE 1262 

SPROG 975 

STAT 564 

STRA 703 

STRB 704 

STSSS 699 

TDMA 630 

TEMP 64 6 

TICST 572 

TIMOT 627 

TLOG 584 

W18 701 

WAIT 339 

WD18A 692 



WD19A 693 

WD20A 694 

WD21A 695 

WD22A 696 

WD23A 697 

WDOUT 322 

WT.A 932 

WT15 1064 

WT15A 1073 

WT2S 911 

ZERO 716 

ZLOG 620 

Macro/1000 Rev. 5000 870612 



238* 
383* 
353* 
369* 

62* 
945* 
920* 

58* 



93' 



128 



1305 



514' 
842' 



1214* 
230* 
224* 
776* 
977* 
1026* 
947* 
1266* 
1274* 
743* 
1033* 
454* 
68* 

1276 
70* 
60* 
1131 
582* 
358* 
521* 
172* 
574* 
64* 
577* 
46* 
176* 
762 
815 
898* 
960* 
1037* 
1141 
1188* 
1240 
48* 141* 



324* 328 773* 777 1065* 1070 
1218 1220* 1221 1299* 1324 



228* 
962* 



979' 



1042* 1196* 1250* 



1028* 1031* 



746* 



749* 1280* 



570' 
851 



572* 
1263* 



621^ 
1268 



629* 
1270* 



1278* 1279 



90' 



118 



824 



885 



1007 



1271 



1118 



1147 



1151 



1176 



1181 



362 



580* 
779* 



784 



95 106 
213 
772 
818* 
917 
964 
1066 
1144* 
1192 
1246 
833* 



142 
727 
778* 
828 
922 
981 
1074 
1156 
1195* 
1249* 

897* 



50* 
52* 
54* 
56* 
484* 
147* 
627* 
1069* 
823* 
279 



744* 
747* 
750* 
752* 
559* 
1174* 
1071* 



768 



759 



145* 

729* 

785* 
831* 
924* 
983* 
1076* 
1159* 
1197 
1310 
913* 
899* 



148 
735 
789 

860 

942 

993 

1096' 

1166 
1200 
1315 
1073 



150* 
736* 
796* 

865 

950 
1000 

1110 

1169' 
1215 
1320 
1097* 



975 1016 



883* 
303 
545 551 
249* 349* 



912 
311 



843 



1032' 
360 



847 



1146' 
394 



1011 



174 
754 
810 
868* 
957 
1035 
1126 
1186 
1236 
1322* 
1172* 



1300 



477 



539 



No errors found 
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5 



General Driver Concerns 



I/O Request Parameters 

The I/O request parameters issued by the user are supplied to the driver in the DVT as shown 
below. The driver parameter area of the DVT may also contain information about the device 
that is not specific to the current request. If the interface driver is being called, the driver 
communication flags in DVT20 may also have meaning. 



DVT15 




Z 


Subfunction 




L 




RQ 


DVT16 


Request Parameter 1 


DVT17 


Request Parameter 2 


DVT18 


Request Parameter 3 


DVT19 


Request Parameter 4 



L88-335 



DVT15 is the control word for an I/O request. The Z bit interacts with the RQ bits, and is 
described below with RQ. 

The SUBFUNCTION format in DVT15 is: 



11 


10 


9 


8 


7 


6 


X 


TR 


X 


EC 


X 


Bl 
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The bits marked "X" are driver-defined. 

TR is transparency mode. 0 is off; 1 is on. 

EC is to echo input: 0 indicates no echo; 1 sets echo on. 

BI is the data format: 0 indicates ASCII; 1 indicates binary. 
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Bits 11 through 6 (all SUBFUNCTION bits) must be set to 1 if and only if the device type is 
30-37 (disks). 



BI and TR operate together to specify a set of data handling circumstances for special 
characters and EOR (end of record) processing. These conventions are explained in the 
Driver Reference Manual. 

It is not necessary for all drivers to support the full set of variances possible. However, 
when it is desirable to handle one or more of these conditions, they should be implemented 
according the beyond those described can be controlled by the X bits. 

L is the mapping location of the buffer. 0 indicates the system map; 1 indicates the user map. 
L=l may also indicate the System Available Memory (SAM) map. Drivers must, therefore, 
never try to find data buffers on their own. They should use $READ/$WRIT or 
$ONER/$ONEW. See Chapter 7 for more information about this pair of routines. 

In DVT15, RQ is the request code itself. It equals 1 for a read request, 2 for write, and 3 for 
control. 

The Z bit, when set, indicates that Parameters 3/4 describes a buffer/buffer length. The Z bit 
may be used for any RQ (1, 2 or 3). 

The interaction between the Z bit and the request code RQ is: 





RQ = 1 or 2 


RQ 


= 3 




Z = 0 


Z = 1 


Z = 0 


Z = 1 


Parm 1 


But Addr 


But Addr 


Simple Var 


Simple Var 


Parm 2 


But Len 


But Len 


Simple Var 


Simple Var 


Parm 3 


Simple Var 


But Addr 


Simple Var 


But Addr 


Parm 4 


Simple Var 


But Len 


Simple Var 


But Len 
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For an RQ of 1 or 2 (read or write), Parameters 1 and 2 describe an input buffer in which the 
driver transfers data. Parameter 1 is the data buffer address and Parameter 2 is the length of the 
buffer. If data is to be accessed in the buffer, the $READ and $WRIT subroutines must be used. 

For an RQ of 3 (control) or 0 (multibuffered request), the user-specified buffer provides 
information to be acted upon by the driver. (An RQ of 0 is covered in the Device/Interface 
Driver Interactions chapter, under the Multibuffered Request section.) 
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To demonstrate some of the possible usages of these optional parameters: 

The DD.00 terminal device driver supports a WRITE/READ request. If RQ is 1 (read) and 



Parameter 1 is the input buffer address 
Parameter 2 is the input buffer length 
Parameter 3 is the output buffer address 
Parameter 4 is the output buffer length 

DD.30 is the disk device driver. It uses optional parameters to define track and sector. If 
RQ is 1 or 2 (read or write) and Z is 0: 

Parameter 1 is the input buffer address 
Parameter 2 is the input buffer length 
Parameter 3 is the track 
Parameter 4 is the sector 



As a general rule, a zero length request should provide the end-of-record handling condition, 
which would normally be supplied if data were actually transferred. Thus, according to the 
TR/BI modes of operation, the general circumstances are as follows. As before, drivers are 
expected to support these operations only where useful. 



Z is 



1: 



Zero-Length Requests 



TR Bl 



Action on Input 



Action on Output 



0 0 



Return zero trans- 
mission log and exit. 



Issue CRLF and/or EOR 
line signal. 



0 1 



Same as above. 



Issue EOR line signal, 
if available. 



1 0 



Same as above 



Return zero transmission 
log and exit. 



1 1 



No operation. 



No operation. 
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Illegal Requests 



Illegal requests are generally handled according to the following rules: 

1. If a driver receives an illegal READ/WRITE requests, the standard procedure to reject the 
request is: 

a. Set error code 1 in DVT16. 

b. Make a "done" exit, which completes the request. 

2. If a driver receives an unsupported zero length read/write request, the driver should ignore 
the request. 

a. Set error code 0 in DVT16. 

b. Make a "done" exit, which completes the request. 

3. Unsupported control requests should be handled in the same way as unsupported zero 
length read/write requests. 



Posting Status 

Status can have several meanings: 

1. Status associated with the request. 

On a read, as an example, a program may need to know how many bytes or words were read. 
This number is the transmission log. The transmission log is posted in DVT17, generally by 
the interface driver. 

2. Status associated with the device. 

For example, a cassette tape may be at the end of the usable area after a request. 

3. There is a possible error associated with the request, even if it completes successfully. For 
example, the request may have succeeded after a number of attempts (as determined by the 
driver). 

Errors will be covered partially in this section and in more detail in the following section. 

Status is posted in the DVT upon completion of a request. Either the device driver or the 
interface driver may post status; any non device-dependent status is posted by the interface 
driver. It is also important to remember that an interface driver may be called directly by a 
program and so it should post as much information as possible. 

There are two places in the DVT to post status: bits 1-7 of DVT6 (the status byte) and all of 
DVT18 and DVT19 (the extended status). The bits in DVT6 are general in nature and may be 
interpreted generally without regard to the actual device. DVT18 and DVT19, however, provide 
device-dependent information or else may help interpret or modify the meaning of the bits in 
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DVT6. The status byte in DVT6 includes an error bit (E, bit 0) which is controlled by the system, 
not the driver. The E bit is set if the driver posts an error code in DVT16 prior to exit. The E bit 
is cleared on initiation of a new request. 

The extended status words may provide detail about an error condition. For example, the error 
code in DVT16 may be a 7 (address error), while information in DVT18 might indicate that the 
cause of the address error was an incorrect sector address. The extended status could also be 
used to record operable but degrading device conditions, such as seek retry counts, etc. 

The format of the DVT6 status byte is given below. There is no defined format for the extended 
status words DVT18 and DVT19. 



7 


6 


5 


4 


3 


2 


1 


0 


EOF 


DB 


EOM 


BOM 


SE 


DF 


DF 


E 



Bit number 
Mnemonic 



Bits 7 through 0 are set by the driver as needed. The E bit is set by the system. 

EOF is End Of File. Use for mini-cassette tapes, card readers, etc. EOF = 1 when 
condition is true. 

DB is Device Busy. Indicates that the device is performing a function which prevents other 
operations from starting, such as tape rewind. DB = 1 when condition is true. 

EOM is End Of Medium. Set when the current request has positioned (or will position) the 
physical medium past the maximum limit (for instance, trying to write 2 disk tracks when 
only 1 track remains for use). 



Note If the EOM bit is set, it is generally a good idea to set the EOF bit also. This 

ensures FMP compatibility. 



BOM is Beginning of Medium. When set, indicates that the medium is at the start of the 
recording area. 

SE is Soft Error. An error occurred which caused the driver to attempt an error recovery 
operation. The E bit may or may not be set, depending upon whether or not the operation 
was eventually successful. 

DF is Driver Definable. 

E is an Error Indicator set by system if the driver sets any error code in DVT16. Drivers 
should not change this bit. 

The status byte is accessible to a program by either making an exec request (an EXEC 3 on 
LU+600B) or by checking the A-register after non-buffered requests. 

Extended status is recovered through a call to RMPAR immediately following a non-buffered 
request. 
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Posting Errors 



Errors are reported in the DVT by the device driver, or the interface driver, or both, according to 
the design on the drivers. If you are writing a device driver to work with an existing interface 
driver (or vice versa), you must have a knowledge of how the other driver interacts with the DVT. 

Drivers report errors by storing error codes in DVT16 bits 0-5. After the driver exits, the system 
will check these bits and, if they are not zero, will set the E bit (any error) in DVT6. 

Error codes 1-12 will result in pre-defined error mnemonics being issued by the system. 
Otherwise, the system will merely report the error number, which may be unique to the device. 
The error code is also accessible programmatically with a status request. 

The default action taken by the system is to down the DVT on the error exit, making it 
unavailable for new requests until it is upped. However, the driver can override the default by 
setting bit 15 in DVT16, as illustrated below. 

When a down DVT is brought up, the request which caused the error is normally re-initiated on 
the device driver. The driver may also override this restart by setting bit 14 in DVT16. This will 
cause the request to be flushed from the I/O queue (removed from the linked request list). 

DVT16 format upon driver exit: 



15 


14 




5 


4 




1 


0 


D 


F 






Error Code 
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D is the DVT down bit. If D = l, then the DVT is not set down on an error; if D=0, the 
DVT is set down on an error. 

F is the flush bit. 1 indicates flush the request; 0 means don't flush it. 
Default: Both bits zero (set the DVT down and do not flush the request. 

The D and F bits will be ignored by the system if the error code is zero. 
Other combinations of the D and F bits and their meanings are: 

DF 

0 1 Set the device down, and flush the request. The request is "finished" in the sense that 

the system will not repeat the request on the driver when the device is upped. This 
implies that the request actually successfully completed. However, during its activity 
some other error circumstance was discovered which requires operator intervention. 

1 1 Do not set the device down but flush the request. This is provided as a soft error 

reporting condition. The request has completed successfully after having some 
difficulty (such as disk retries). This condition is also forced by the system if the caller 
set the UE bit (normal requests only). 
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1 0 Do not set the device down, and do not flush the request. The resulting action is to 
restart the request. This, in combination with error code 63 (77 octal) is used in 
driver-directed power fail recovery. The request is automatically restarted by a new 
initiate entry. 

The case where both bits are zero is most common. For example, if a line printer is out of paper, 
it is best to set the device down but not flush the request. When the device is set down, the 
program making the request is suspended. 

When new paper is installed, the operator can set the device up and the request will complete. 
Programs which make new requests on the device while it is down will be suspended until the 
condition is corrected and the device is upped. 

The device driver may put itself in the time list and up itself when it finds the condition 
corrected. See section on system callable routines. 

A driver would normally instruct the system to flush the request only if the request was illegal 
(such as illegal track specified on a disk read/write), since re-initiating the request would lead to 
the same error. 

The effect of setting the error code in bits 5-0 of DV16 is shown in Table 5-1 below. 



Table 5-1. Error Codes and their Meanings 



Error Code (Decimal) 


Meaning 


0 


No Error 


1 


Illegal Request 


2 


Not Ready 


3 


Time Out 


4 


End of Tape 


5 


Transmission Error 


6 


Write Protected 


7 


Address Error 


8 


Serial Poll Failure (HPIB) 


9 


Group Poll Failure (HPIB) 


10 


Fault 


11 


Data Communication Error 


12 


Insufficient DVTX or DVTP 


13 to 20 


Reserved 


21 to 59 


Driver Definable 


60 to 62 


Reserved 


63 


Restart if D=1, F=0 



Error code 63 is unique, since it permits the request to be re-initiated with no error message 
even though the driver made an error exit. However, to cause automatic restart, the driver must 
set the D bit (do not set the DVT down). 

The following message is reported when a device error occurs. The first two lines always appear. 
The last two appear only when the device is set down or the request is flushed. 
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I/O Device Error on LUnn 



The reason is: 



<meaning> (From Table 5-1) 

Device has been downed (use UP to try recovery) 
Request has been flushed 



Driver Partitioning 

In order for a driver to be generated into a partition during system generation, it must contain 
the gen record GEN PARTITIONABLE. This record implies that the driver will be mappable 
during system execution. The term mappable means that the driver does not perform DMA to 
or from its code space. It is, however, proper to perform DMA from a table, such as the DVT or 
IFT, or from the user buffer. The DMA control words must not be part of the driver's code 
space. They should be in the DVT or IFT extension area, usually the IFT area. 
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Device and Interface Driver Interactions 



Parameter Passing Between Drivers 

All communication between device/interface driver pairs is via the DVT. Information passed to 
the device driver about the user's request is contained in DVT15-DVT19. The device driver will 
examine the request parameters and may replace one or more of them with its request on the 
interface driver. 

When the interface driver completes, it posts status in DVT6, error code (if any) in DVT16 and 
transmission log (positive number of bytes or words transmitted) in DVT17. Extended status 
information (if any) should be stored in DVT18 and DVT19. The device driver may again modify 
the DVT before completing the request. For example, the extended status information may have 
more meaning when considered in terms of the actual device and may cause the device driver to 
reinitiate the request on the interface driver. This permits the device driver to handle error 
recovery procedures. 

Generally, the interface driver should operate on the DVT as if the device driver did not exist. 
(This may not be feasible in some cases.) If there is a need for direct communication between the 
device driver and the interface driver, this is accomplished through the driver communication bits 
in DVT20. 



Multibuffered Request 

The multibuffered request (RQ=0) is a chain of requests built by the device driver and passed to 
the interface driver. The device driver will never receive a request of this type. This capability 
permits the device driver to break up a complex request into a series of simpler operations. 

The interface driver is initiated once, to begin the chain and the request is not complete until the 
chain completes. The interface driver uses the chain to build a chained DMA request. For a 
discussion of DMA chaining, see the chapter on I/O Card Processing. 

The format of the multibuffered request is defined totally by the interface driver and no standard 
is enforced regarding format. In the following discussion, an approach is discussed but other 
approaches are equally valid. 

The device driver builds the request chain in the DVT extension and sets the RQ field (DVT15) to 
0 prior to initiating the interface driver. The address of the chain (in this case the DVT extension) 
is put into DVT16 and the total length of the chain in DVT17 as a negative link count. DVT18 and 
DVT19 may be used to pass additional control information to the interface driver. 
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When a device driver is making multibuffered request links, it is responsible for setting the L bit to 
the correct value for each link. Each link normally corresponds to 1 DMA request. If a link 
represents the request data buffer, then the L bit should be set to the same value as the L bit in 
DVT15. If a link represents data from the driver's own area (the driver extension area) then the L 
bit should be set to zero. 

Each link in the chain uses the following format: 



15 


14 


13 


12 


11 


10 


9 


8 


7 


6 


5 


4 


3 


2 


1 


0 


LEN 


Z 


Subfunction 


0 0 


L 


0 


RQ 



Buffer Address 



Buffer Length 



Control Word 



Control Word 



> LINK 



LEN is the length of link in chain (1 to 5 words). 

RQ is the request type for this link (1 for read, 2 for write, and 3 for control). 

Z is the control buffer bit. If present, 4th and 5th word of link are address and length of a control 
buffer. 



L is the location (system/user) bit, defining whether data is in the system or user map. 



I/O Table Reference 

The system sets up pointers to the words in the DVT prior to entering the device driver. Also it 
sets up pointers to the IFT prior to entering the interface driver. 

There are times however when the device driver will wish to reference entries in the IFT or the 
interface driver will wish to reference entries in the DVT. To reduce overhead, the system does 
not set up the pointers for such a cross reference (except on Interface Initiate and Abort) and so 
the driver must do this for itself. 

A system subroutine, $DIOC, facilitates access by a driver to any DVT or IFT. This routine can be 
called by either the device or the interface driver. After calling this routine with the appropriate 
control parameters, the driver may directly access the DVT or IFT words by loading the word 
indirectly. See the chapter on Callable System Routines for more information on $DIOC. 

If a single address is all that is needed, it may be more efficient for the driver to compute the 
address needed rather than call upon $DIOC. 
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Asynchronous I/O and Polling 



In any truly asynchronous transfer, the time interval between operations is variable and may be 
quite lengthy. 

One such instance is a read or write request to a disk. The request will have two basic 
components: the seek-to-cylinder and the actual transfer of data. If the objective is to use the I/O 
card efficiently in the case where there may be many devices on the bus (as an HP-IB), then it is 
desirable to permit additional requests to be handled by the interface driver between the seek and 
the data transfer. 

Another instance is in the polling of devices on the bus. It is desirable to initiate a poll request to 
several devices as quickly as possible, without waiting for each device to respond. Then the 
responses can be serviced as they come in. In the meantime, other requests should be permitted 
on the bus. 

A third example applies to handling of terminals. A terminal should be able to respond an 
operator attention key and also be used for programmatic I/O. However, a terminal must be 
specifically enabled to permit recognition of an operator attention key. The enable request must 
complete so that programmatic requests are not held off. 

To implement this feature, the interface driver must accomplish a "pseudo done" exit, which must 
be recognized by a co-operating device driver. The device driver then waits for "true done" (the 
seek has completed or the polled device responded). 

For "pseudo done" the interface driver adds to an internal list the DVT address which must be 
used when the device makes a response. It then makes a "done" exit. As far as the system is 
concerned, the request is actually done and new requests may be started on the interface driver — 
this is important to keep the interface card as busy as possible. 

In making the "done" exit, the interface driver may set the D bit in the system flags to defer calling 
the device driver. This would introduce the necessity for the interface driver to manage the 
timeouts, however. The default condition (D bit clear) will result in the continue entry to the 
device driver whose DVT is given in IFT5 and is a simpler situation for the driver to handle. 

When an interrupt occurs and the device driver is entered, it recognizes, by the nature of the 
request and (possibly) the driver communication flags in DVT20, that the request is either actually 
complete or still in progress. If not complete, then the device driver makes a "wait" exit. 

When the device makes the desired response, the interface driver consults its list to identify the 
device driver that should handle the request. It then places the correct DVT address in IFT5. It 
may then call system subroutine $DIOC to set up the pointers to the DVT and, possibly, set a flag 
in the driver communication area. It, again, makes a "done" exit, which causes a continue entry to 
the same device driver as previously. This time, however, the device driver handles it as a 
completion of the original request and makes a device done exit. (See the Callable System 
Routines for more on $DIOC.) 

The device done exit causes the rescheduling of any program waiting upon the request. Therefore, 
there is no "pseudo done" for the device driver. 
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$DIOC: Set Up DVT or I FT 

Subroutine $DIOC may be used by either a device driver or an interface driver as follows: 



A-Register Bits = 


2 


1 


0 




A 


I 


D 



A = Advance DVT ref at IFT5 
I = Set up IFT address pointers 
D = Set up DVT address pointers 



88-341 



B Reg = DVT Address 
JSB $DIOC 

Return: P+l Registers meaningless 

If used by the device driver then only the I bit makes sense on entry to $DIOC. The device driver 
might wish to set up the IFT pointers so that it could place some value (s) in the IFT extension (for 
example) prior to an "initiate" exit. 

If used by the interface driver, then either "A" or "D" may be used or both may be set. "I" may be 
set but makes no sense (because the IFT addresses are already set up). If both 'A' and "D" are 
set, the advance to the next DVT in the circular list is made prior to setting up the DVT pointers, 
so that the pointers refer to the next DVT. "A' by itself merely changes the contents of IFT5 to the 
address of the next DVT. 

Since the circular list pointer will point to itself if there is no circular list, the routine will work 
properly even if there is only one DVT attached to the IFT. 
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$DVLU: Compute LU From DVT 



$DVLU finds the first logical unit number associated with the DVT. The calling sequence is: 

B-Register = DVT Address 

JSB $DVLU 
Return: P+l 

A-Register has LU number (or zero if no LU assigned) 
B and E registers unchanged 



$UPIO: Up Device 

$UPIO is not a closed subroutine*; it is accessed by a JMP instruction rather than a JSB. 

The driver jumps to $UPIO to "up" a device whose DVT pointers have been previously set up. All 
programs waiting on the downed device will be rescheduled by the system. 

All requests in the queue will be allowed to continue. 

* In this context, closed subroutines return to the caller. Routines that are not closed do 
not return. 



Note Drivers should not jump to $UPIO if the device is busy. Also, they should 

ensure that "hold" in the system flags was not left set from a previous exit. This 
is to ensure that the driver will be re-entered. 



$Uplft: Up all LUs referring to this I FT 

$UpIft is not a closed subroutine*; it is accessed by a JMP instruction rather than a JSB. The 
driver jumps to $UpIft to "up" all devices whose DVT refer to the currently set up Ift. The result 
is the same as calling $UPIO for each DVT that refers to this Ift. This call is intended to be used 
by interface drivers for devices such as disks that have several DVTs referring to the same physical 
device. 

* In this context, closed subroutines return to the caller. Routines that are not closed do 
not return. 
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$DMPR: DMA Parity Error 



If a DMA parity error is received by the driver, it may enter the system with a JMP to $DMPR to 
allow the system to process the error. 

If the parity error occurs in the operating system area, the system will execute a HLT instruction. 
The A- Register will contain the failing page address, and the B -Register will contain the physical 
page number. 

If the parity error occurs in a user partition and the error is a hard parity error, the partition is 
downed, a message is given to the system console, and processing resumes. 



$XQSB: Program Scheduling 

$XQSB may be used by a device driver to schedule a program, pass it up to five parameters, and 
also change the terminal logical unit stored in the ID segment. 

The calling sequence is: 

JSB $XQSB 

DEF <Program Name in 3-word buffer> 
DEF <5-word parameter buffer> 
DEC <new logical unit> 
Return: P+4 

Program not found A = -1 B = 0 

Program busy A > 0 B = ID address 

Successful schedule A = 0 B = ID address 

If the program is busy, the A-Register will contain the status bits from ID segment word 16. 

The parameter address in the 5-word parameter buffer should be direct or indirect to a list of five 
parameter addresses. 

If the logical unit passed is zero, then the terminal LU is not changed in the ID segment. 

RTE drivers used to follow a recommended convention in using the five -word buffer as follows: 
Word 1 is the LU of the device from which the schedule attempt was initiated. 

Word 2 is an arbitrary value taken from the control request 20B when used to setup the 
program to schedule on asynchronous interrupt. 

Words 3 to 5 are one to three words of device driver status information which may be used by 
the scheduled program. 

The current convention (Rev 4.1 or later) is as follows: 

1. LU 

2. 0 or - 1 0 for primary program; - 1 for secondary 

3. DVT 6 Word 

4. 0 (Spare) 

5. 121217B 
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Adherence to these recommendations will permit automatic trap handling in BASIC/1000D and 
BASIC/1000L. 

On systems using Security/1000, drivers calling the $XQSB routine for purposes other than 
scheduling a program on unsolicited interrupt may lock up. (For example, a driver may call an 
update program every time it exits.) 

Driver lock up can be prevented by using one of the following procedures: 

4. The driver can set the value of the executing session number (operating system parameter 
$XQSN) to zero prior to calling the $XQSB routine. If $XQSB is set to zero, the capability 
level defaults to the session capability level. 

5. If unable to modify the driver source code, use the LINK PC command when linking the 
program, and specify a value of zero for the RQUSCPLV parameter. This sets the required 
user capability level to zero. 



Mapping Considerations 

The operation of a system with mapping (such as RTE-A) requires special procedures for data 
manipulation as well as DMA configuration. At times, drivers must examine and/or modify an I/O 
request's buffer. The data buffer may or may not be mapped in. To make mapping as transparent 
as possible to the driver writer, the operating system includes a set of subroutines that allow the 
driver to read or write into the data buffer without having to consider mapping. HP strongly 
advises that all drivers use the subroutines described below. 

In A-Series systems: 

1. The Operating System is always mapped. 

2. The user map (map set 2 or 3) is mapped if data is in the user space. 

3. SAM is always mapped (map set 4). 

4. The auxiliary map (map set 7) is used so that the user map is not modified. 

5. Twenty-four port maps (map sets 8 through 31) are available for DMA, and are dynamically 
allocated and deallocated between the 48 I/O channels as needed. 

The following lists all of the map set assignments: 

0 System 

1 System/message processor 

2 User data 

3 User code 

4 SAM 

5 (reserved) 

6 DS 

7 Auxiliary 

8-31 Port maps for DMA access 
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The L bit referenced below is normally found in DVT15, but can be found in the control word for 
a multibuffered request. In both cases, the L bit has the same function. Device drivers should set 
the L bit in multibuffered request control word to indicate which data buffer is being referenced, 
the original request data buffer, or a data buffer from the driver's area. If the data buffer is in the 
driver code space (as in a non-partionable driver) or in the driver extension area (as in a 
partitionable driver), the L bit should be zero. If it is the original request data buffer, this bit 
should be set the same as the L bit in DVT15. 

There are three sets of mapping routines described below. They are $SETM/$READ/$WRIT, 
$ONER/$ONEW, and $MSALC/$MSRTN. The first set is recommended, because each call to 
$ONER/$ONEW takes as long as a call to $SETM plus $READ/$WRIT. $SETM must be called 
before calling $READ/$WRIT, but it must be called only once per entry and it does not have to be 
called at all during initialization. $MSALC and $MSRTN are used from within a driver for 
allocating multiple map sets for a driver and also by the I/O system for allocating map sets. 

$SETM: Set Up Map Registers 

$SETM sets up the map registers for the $READ and the $WRIT subroutines. The 
$SETM/$READ/$WRIT set of routines is useful if the driver has to manipulate more than one 
data word between driver entry and driver exit. $SETM does not need to be called if the driver 
was entered with an initiation directive because the map registers are set up automatically by the 
system. In all other cases, if a driver is to use $READ or $WRIT, this routine should be called 
first. 

The calling sequence is: 

B-Register = DVT address 

JSB $ SETM 

Return: P+l A and B unchanged 



$READ: Read Data Word/Map Selected 

$READ allows the driver to read one word from the data buffer, but assumes that all map 
registers have been set up prior to this call. This routine, in conjunction with $SETM, should be 
used if more than one word needs to be read. If a driver has been entered with an "initiate" 
entrance, this routine can be used without a call to $SETM, because the system has already set up 
the maps. 

The calling sequence is: 

B-Register = logical address 

(base address provided in request plus offset) 

JSB $READ 

DEF (word containing L bit in bit 3) 

Return: P+2 A = Data value; B, E unchanged 
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$WRIT: Write Data Word/Map Selected 



$WRIT is the converse of $READ: it writes one word into the data buffer. If a driver has been 
entered with an "initiate" entrance, this routine can be used without a call to $SETM, because the 
has previously set up the maps. In all other cases $SETM must be called to set up the maps. 

The calling sequence is: 

A-Register = Data value to be stored 
B-Register = Logical Address 

(base address provided in request plus offset) 

JSB $WRIT 

DEF (word containing L bit in bit 3) 
Return: P+2 A, B, E unchanged 



$ONER: Read One Word Without Setup 

$ONER allows the driver to read one word from the data buffer. This is useful if the interface 
driver is resumed, but does not want to go through the overhead of setting up the complete map 
set. This routine should never be used if the driver has been entered on an Initiate entrance, 
because the maps have already been set up by the system. $READ should be used in place of this 
routine. 

Calling sequence is as follows: 

B-Register = logical address of word to read 

(base address provided in request plus offset) 

JSB $ONER 

DEF (word containing L bit in bit 3) 
DEF (DVT) 

Return: P+3 A = data read; B, E unchanged 
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$ONEW: Write One Word Without Setup 



$ONEW allows the driver to write into the data buffer. Again, this routine should not be called if 
the driver has been entered on an initiate entrance, because the maps have already been set up by 
the system. $WRIT should be used in its place. 

Calling sequence is as follows: 

A-Register = Value to be written 
B-Register = Logical Address 

(base address provided in request plus offset) 

JSB $ONEW 

DEF (word containing L bit in bit 3) 
DEF (DVT) 

Return: P+3 A, B, E all unchanged 



$SETR: Set Port Map 

$SETR sets the port map for a request in the DVT. This is useful for setting up the correct port 
map for the DMA transfer to and from the user buffer. $SETR does not need to be called on 
request initiation; the driver is entered with the correct port map setting. On any other entry (that 
is, asynchronous interrupt which must initiate a DMA request), this routine should be called. 

The port map is returned in the A-Register, and should be OR'd into the DMA control word of the 
quad that does the actual data transmission. This routine makes a call to $SELR to obtain the 
port map number, so both need not be called consecutively (see below). 

B-Register = DVT address 
JSB $ SETR 

Return: P+l B= starting physical page of transfer 
A = port map number 

For example: JSB $SETR 

IOR CNTZ1 

This would logically OR the port map into the DMA control word. 
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$SELR: Select Port Map Number 



$SELR is used to find out what map set an I/O channel should use for DMA. $SELR will check to 
see if the I/O is coming from the system or SAM map. If so, and the driver is not going to change 
the mapping registers, $SELR will return a 0 for the system map or a 4 for the SAM map. 
Otherwise, it will check to see if a port map has been allocated for this channel. If one has been, 
that port map number will be returned to the caller. In case a port map needs to be allocated, 
$MSALC will be called to get one. If no map sets are available, the I/O will be suspended until a 
map becomes available. 

This subroutine must be used when setting up the DMA control register (register 21, see Chapter 
9, I/O Card Programming) for the actual data transfer to or from the user's buffer. The number 
returned should be OR'd into the control word and stored in the self-configuration quad or output 
directly to register 21. The relocation number in this case is zero. $SELR can be used only if the 
driver has been entered with an Initiate entrance. In all other cases, $SETR should be used. 

The calling sequence is: 

A-Register = address of word containing L bit in bit 3 

B-Register = IFT address 
JSB $SELR 

Return: P+l A = port map number 

For example: JSB $SELR 
IOR CNTZ1 

This would logically OR the port map number into the DMA control word. 
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$MSALC: Allocate Additional Map Sets 



$MSALC allows a driver to allocate additional map sets for setting up multiple DMA transfers. 
Use $SELR or $SETR to get the first map set, but use $MSALC to allocate any map sets after 
that. See $SELR, above, for a description of setting the DMA quad. 

The calling sequence is: 

A-Register = IFT 
JSB $MSALC 
Return: P+l A = 
Return: P + 2 A = 

For example: 

LDA IFTA 

JSB $MSALC 

JMP NOMS 

STA MapSetNum 

IOR CNTZ1 



$MSRTN: Deallocate a Map Set 

$MSRTN is used to deallocate a map set that has been allocated using $MSALC. 

The calling sequence is: 

A-Register = IFT address 

B-Register = Number of port map to return 
JSB $MSRTN 

Return: P+l Error, port map did not belong to the IFT specified 

Return: P+2 Success 

For example: 

LDA IFTA 

LDB MapSetNum 

JSB $MSRTN 

JMP ERROR 

JMP SUCCESS 



address 

-1, no port map available 
allocated port map number 
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$CLWRT: Class I/O from a Driver 



This driver callable subroutine allows a driver writer to either initiate a class request, or to deliver 
a buffer of data to a class completion queue. This subroutine accepts calls in two forms which are 
described separately below. 

Form 1, deliver a buffer to a class completion queue: 

This form allocates memory from SAM (system available memory), initializes it as a class request, 
copies the data from the driver to the class buffer, and then queues the buffer on the class 
completion queue. 

DBuff oct MapReg this describes where the data is located 

def Message 



• other code 



Ida =L (DBuff) 
ldb ClassNumer 



jsb $ClWrt 

def Length 

def CValues 

ssa 

jmp Oops 



A = an address of a buffer descriptor 
B = a previously allocated class number, 
usually this has been passed 
to the driver in a control request 
invoke the routine 

passing the length of the buffer (+words/-bytes) 

and a pointer to the call value array 

the call returns here, 

the A-Register has the status 



• other code 



CValues oct ccc 

oct nnn 

oct optl 

oct opt2 



control word (see below) 
tag word 

option word 1 (see Z-Bit section below) 
option word 2 



Message bss xx The data to be sent 

A-Register return values: 



0 success 

-3 no SAM available 

-4 class module not gen' ed into the system 

-5 class queue is in buffer limit state 

-6 bad class number 
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Form 2, initiate a class request on an LU: 

This form allocates memory from SAM, initializes it as a class request, and then queues the 
request on the DVT of an LU. 

DBuff oct MapReg this describes where the data is located 

def Message 

• other code 



Ida =LuNumber A = an LU in the range 1. . .2 55 

ldb ClassNumer B = a previously allocated class number, 

; usually this has been passed 

; to the driver in a control request 

jsb $ClWrt invoke the routine 

def Length passing the length of the buffer (+words/-bytes! 

def CValues and a pointer to the call value array 

ssa the call returns here, 

jmp Oops the A-Register has the status 



• other code 



CValues oct ccc 

oct nnn 

oct optl 

oct opt2 



control word (see below) 
tag word 

option word 1 (see Z-Bit section below) 
option word 2 



Message bss xx The data to be sent 

A-Register return values: 



0 success 

-1 call initiation collision 

-2 bad LU number 

-3 no SAM available 

-4 class module not gen' ed into the system 

-5 class queue is in buffer limit state 

-6 bad class number 



If this request is directed to an idle LU, then the I/O request must be initiated when the driver 
exits. To do this, the system points the DVT request queue word to the class buffer and then puts 
the DVT address into a system flag. The system flag word can contain only one value, so if the 
driver encounters two idle LUs, it will receive error -1. If the request is directed to a busy LU, 
the request is simply added to the end of the DVT request queue and there is no need to set the 
system flag word. Thus, the only way that the - 1 error can be generated is if the driver tries to 
initiate calls on multiple LUs in a single pass through the driver. 
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The form of the control word expected is close to that as seen by drivers in DVT word 15: 



15 


14 


13 


12 


11 1 


0 9 


8 


7 


6 


5 


4 


1 
J 


2 


1 


0 


CLO 


0 


0 


Z 


Subfunction Bits 


0 


0 


0 


DB 


RQ 



Bits 0,1 



Bit 2 



Bits 6-11 



(RQ) 



(DB) 



Request Code Bits 

00 - not valid 

01 — read 

10 - write 

11 - control 

Driver Bypass Bit 

0 — enter the device driver 

1 — bypass the device driver, 

send the request directly to the interface driver 

Standard Subfunction Bits, 

the interpretation of these bits is driver dependent 



Bit 12 



Bit 15 



(Z) Double Buffer Bit 

0 - no double buffer 

1 - build the class request with a 'Z' buffer in it. 

(This is not very useful, as no data is put in the buffer.) 

(CLO) Class Limit Override 

0 — See if the given class number is in buffer limit suspend state. 

If it is, return —5 error. 

1 - Do not check for buffer limit suspend. 



7-12 Callable System Routines 



Update 1 



8 



Privileged Drivers 



A privileged driver is a special interface driver which is permitted to interrupt the operating 
system and other lower priority privileged drivers. 

Privileged drivers have two entry points: 

1. ID.yy, the standard entry point for any interface driver. 

2. Pl.yy, the privileged entry point. 

The generator places a JSB to the privileged entry point (through a link word) in the trap cell for 
the driver's select code. When the interrupt occurs, the driver is entered without the knowledge of 
the operating system. 

For the standard entry point, the driver is written like any other interface driver. This entry is 
under control of the operating system and used to initiate the request. 

On privileged entry, the driver must save the present state of the processor (register values, 
memory protect fence, etc.) and restore it prior to exit. 

Because a privileged driver can interrupt the system, the driver may not use any system routines in 
its privileged section. If it must post any information in the DVT or IFT, it must have 
previously-saved pointers to the correct addresses, which can be easily obtained when the request 
is initiated. The driver must also perform mapping functions, if the data needs to be examined. 
Because this storage is local to the driver, any privileged driver that handles more than one select 
code will have to manage separate storage areas for each select code. 

Generally privileged drivers must disable interrupts for part of their operations. The interrupts 
should be enabled whenever possible to permit interrupts by higher-priority privileged select codes 
to be quickly serviced. 

The method of returning from a continuation entry will depend upon whether more entries are 
expected or the request is done. For a done exit, it will also depend upon whether the system or a 
program was interrupted. In the latter case, the system may be entered by the driver to complete 
done processing. Otherwise, done processing is deferred by placing the IFT on a privileged done 
list for the system to process at the earliest opportunity. 

If a program (rather than the system) is interrupted, the driver may enter the system directly to 
complete done processing. Prior to exit, however, it must set up the register values and the point 
of suspension of the program that was interrupted; see the table below. 

Table 8-1 lists the global values and entry points which must be accessed by the privileged driver to 
perform the save-and-restore tasks normally performed by the system. 

The following program listing shows how the save-and-restore tasks are performed in a privileged 
driver. The sample driver controls the general purpose interface card. The driver is not a 
Hewlett-Packard product, and it does not represent current programming standards. It is included 
only to show how a privileged driver performs tasks normally performed by the system. 
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Table 8-1. Global Values/Entry Points Needed by a Privileged Driver 



Entry Point 


Meaning 




P Rpni^tpr 


$A,I 


A Register 


$B,I 


B Register 




n anrl O Rpni^tpr^ 


•fcFO 1 


i — cii ivj w ncyioLci o 


vp/\ 


V Rpni^tpr 


>J> ■ 


Y Rpni^tpr 




7 Rpni^tpr 


$MPTF 


Memory Protect Flag (0 = on) 


$PDON 


Privileged Driver Done Exit (if MPTF off) 


$PIMK 


Privileged Interrupts Mask value 


$Q.PV 


Head of privileged drivers done list 


$WMARI 


Enabled memory maps 
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ASMB, R, L, C 

NAM ID. 51 781009 

* 

* MICROCIRCUIT PRIVILEGED DRIVER FOR HISTOGRAMMING 

* DESIGNED TO SERVE AS AN EXAMPLE OF PRIVILEGED DRIVERS 

ENT ID. 51, PI. 51 

* 

EXT $A, $B, $EO, $SUSP 

EXT $PIMK, $MPTF, $Q.PV, $WMAP 

EXT, $IF7, $DV15, $DV16, $DV17, $DV18, $DSV19 

EXT, $PDON, .XJCQ, .SIMP, .CIQA, .CZA, $WMAP, $X, $Y, $Z, $CQ 



ID 



SUP 

.51 NOP 

AND B7 
CPA Bl 
JMP INIT 



ENTERED FROM IOC 



NEW REQUEST INITIATION 



CPA B3 

JMP TMOUT TIMEOUT 
TREAT AS AN ABORT 

JMP DONEX TAKE PHY DONE EXIT 

SPC 3 
REQUEST INITIATION 



INIT LDA $DV16 
STA DVT16 
LDA $DV15, I 
AND B3 
CPA B3 
JMP CNTRL 
CPA B2 
JMP REJCT 
SKP 



SAVE ADDR OF DVT 16 



CONTROL REQUEST? 
YES 

WRITE? 

YES, REQUEST ERROR 



HISTOGRAM REQUESTS HAVE THIS FORMAT 
JSB EXEC 
DEF *+7 
DEF . 1 



DEF LU 
DEF BUFR 
DEF LEN 
DEF ADDR 
DEF #INWD 



READ 

LU OF PRIVILEGED MICROCIRCUIT DVR 

ADDR FOR HISTOGRAM RESULTS 

SIZE OF HISTOGRAM BUFFER 

1ST CORE LOCATION TO HISTOGRAM 

# OF WORDS PER HISTOGRAM BUFR CELL 



THE AREA OF CORE HISTOGRAMMED WILL BE FROM (ADDR) TO 
(ADDR) + (#INWD) * (LEN-1) -1 . THE FIRST WORD OF THE HISTOGRAM 
BUFFER RECEIVES THE NUMBER OF "HITS" OUTSIDE OF THE ABOVE 
RANGE. WHEN ANY CELL REACHES 177777B, IT IS NO LONGER 
BUMPED, HENCE THIS VALUE REPRESENTS OVERFLOW. 



SIZE OF BUFFER- 1 

TIMES # WORDS PER CELL 



CCA 

ADA $DV17, I 
MPY $DV19,I 
SZB, RSS 

CMA, SSA, INA, RSS NEGATE 

JMP REJCT ERROR IF <0 OR »327 67 
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STA 

LDA 

STA 

LDA 

STA 

LDA 

CMA, 

STA 

DLD 

DST 

LDA 

STA 

LDA 

STA 



NRANG 
$DV19, I 
#WD 

$DV16, I 

BUFAD 

$DV18, I 

INA 

NEGAD 

#MEAS 

MEASX 

$IF7 

IFT7 

$IFTX 

IFTX 



SAVE FOR RANGE CHECKING 
WDS PER CELL 

GET HISTOGRAM BUFR ADDR 
SAVE LOCALLY 
GET CORE ADDRESS 

- CORE ADDR FOR RANGE CHECK 
NEG # OF HISTOGRAMS (2 WORD) 

ADDR OF IFT7 

SAVE LOCALLY 

ADDR OF IFTX 

SAVE LOCALLY 



NOW START PHOTOREADER TO CAUSE PRIVILEGED INTERRUPTS 



ISZ ID. 51 
STC 30B,C 
CLA 

JMP ID. 51, I 



TAKE PHYSICAL CONTINUE EXIT 



.0. 



NO T. 

EXIT 
SKP 

* THIS IS THE PRIVILEGED INTERRUPT SECTION OF ID. 51 
PI. 51 NOP 



CLC 


4 


I URN— Or r EVERYBODY 


JSB 


. SIMP 


SAVE 


DEF 


WMAP 


WORKING MAP 


DST 


ASV 


SAVE REGS 


ERA, 


ALS 




SOC 






INA 






STA 


EOSV 


SAVE E&O 


JSB 


. CIQA 


SAVE Q 


STA 


QSAV 




JSB 


. CZA 


SAVE Z 


STA 


ZSAV 




LDA 


$MPTF 


GET MEMORY PROTECT STATE 


STA 


MPFSV 




ISZ 


$MPTF 


FLAG THAT MEM PROTECT IS OFF 


LIA 


2 


READ GLOBAL REGISTER 


STA 


GLOBL 




LIA 


4 


GET INTERRUPTING S.C. 


OTA 


2, C 


SET & ENABLE GLOBAL REG 


LIA 


0 




STA 


INTMASK 




LDA 


$PIMK 


MASK ALL BUT 


OTA 


0 


PRIVILEGED INTERRUPTS 


NOP 




**TEMP 


STC 


4 


REENABLE INTERRUPTS 


;togramming 


UPDATE 


LDA 


NEGAD 




ADA 


PI . 51 


INTERRUPTED L0C-1ST HISTOGRAM 


SSA 




OUTSIDE OF RANGE? 


JMP 


OUTRG 


YES 


LDB 


0 


OFFSET 


ADB 


NRANG 




SSB, 


RSS 


BEYOND UPPER LIMIT? 


JMP 


OUTRG 


YES 


CLB 
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DIV #WD 
ADA BUFAD 
INA, RSS 
OUTRG LDA BUFAD 
LDB 0,1 
INB, SZB 
STB 0,1 

* 

ISZ MEASX+1 
JMP PCONT 
ISZ MEASX 
JMP PCONT 
2 



ADDRESS HISTOGRAM BUFFER 

OUT-OF-RANGE, USE 1ST LOC 
GET CURRENT CONTENTS OF CELL 
BUMP IT, SKIP IF OVERFLOW 
NON-OVERFLOW, CELL=CELL+1 

COUNT TOTAL 

INCR UPPER WORD OF COUNT 



SPC 

TOTAL # OF HISTOGRAMS HAS OCCURRED, COMPLETE NOW! 

CLC 30B,C CLEAR CARD 

SPC 2 

THE BELOW CODE SERVES AS AN EXAMPLE OF HOW PRIVILEGED DRIVERS 
MAY COMPLETE A REQUEST TO THE OPERATING SYSTEM WITH MINIMUM LATENCY 
SPC 1 

CLC 4 INTERRUPTS OFF 

UPDATE SYSTEM FLAGS - "T" WOULD BE MEANINGLESS 
ADDR OF IFT7 
GET IFT WD 7 
CLEAR BITS 15-11 
SYS. FLAGS ALL ZERO 



LDB IFT7 

LDA 1, I 

AND =B3777 

STA 1, I 
CLA 

STA DVT16, I 

CPA MPFSV 

JMP PDNOW 



POST GOOD COMPLETION 
WAS SYSTEM INTERRUPTED? 
NO, WE CAN ENTER IT NOW 



* ENQUEUE THIS IFT ON "$Q.PV" QUEUE OF PRIVILEGED IFTS REQUIRING 

* PHYSICAL DONE PROCESSING SO THAT I/O SYSTEM WILL PERFORM A P.D. 

* FOR THIS IFT RATHER THAN RETURN IMMEDIATELY TO USER PROGRAM 

* WHEN THE CURRENT SYSTEM PROCESS COMPLETES. 

* 

LDB IFTX POINT TO IFT EXTENSION 

LDA $Q.PV GET CURRENT HEAD OF $Q.PV" QUEUE 

STB $Q.PV PUT OUR IFT AT HEAD - LIFO 

STA 1,1 LINK TO NEXT GOES IN IFT EXT WD #1 



RESTR LDA EOSV 
CLO 

SLA, ELA 

STO 

LDA GLOBL 

OTA 2,C 

LDA MPFSV 

STA $MPTF 

LDB ASV+1 

LDA INTMASK 



RESTORE E 
SET 0 

RESTORE/ENABLE GLOBAL REG 

RESTORE M.P. FLAG 
RESTORE B REG 



NOTE THAT SERVICING OF A TBG TIME TICK MAY 
DELAY THE INTERRUPTED PRIVILEGED DRIVER. 
IF THIS IS A PROBLEM, THE PRIVILEGED DRIVER 
SHOULD RUN WITH INTERRUPTS OFF. THE TBG TICK 
WILL THEN BE DELAYED (NOT LOST) . 



OTA 0 



UNMASK ALL INTERRUPTS 
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LDA ASV 
STC 4 
JSB .XJCQ 
DEF WMAP 
DEF PI . 51, I 
DEF QSAV 



INTERRUPTS ON 



RETURN TO POINT OF INTERRUPTION 



HERE WHEN MEMORY PROTECT WAS ON SO THAT I/O SYSTEM 
CAN BE ENTERED DIRECTLY FOR PHYSICAL DONE 



PDNOW ADB N6 
LDA ASV 
STA $A, I 
LDA ASV+1 
STA $B, I 



POINT TO IFT WORD 1 
SAVE MACHINE STATE 
ON INTERRUPT IN 
ID SEGMENT OF 
CURRENTLY EXECUTING 



PUT LOCAL STATE WHERE RTE CAN FIND IT 



CXA 

STA $X 
CYA 

STA $Y 

LDA QSAV 

STA $CQ 

LDA ZSAV 

STA $Z 

LDA WMAP 

STA $WMAP, I 

LDA EOSV 

STA $EO, I 

LDA PI. 51 

STA $SUSP, I 



SAVE X & Y IN 
USER BASE PAGE 



SAVE Z-REGISTER FIRST AND RESTORE 
SAVE WMAP 



SET POINT OF 
PGM SUSPENSION 



ENTER IOC WITH B REGISTER POINTING TO THE IFT WORD 1 



STC 4 

JMP $PDON 

SPC 4 

PCONT CLC 4 

STC 30B,C 

JMP RESTR 
SKP 



INTERRUPTS ON 

PROCESS PHYSICAL DONE NOW! 

INTERRUPT SYSTEM OFF 

RESTART PR 

RESTORE REGS & EXIT 



HERE FOR CONTROL REQUESTS 



CNTRL LDA $DV15, I 
AND B77 0 0 
CPA B4000 
JMP SETSZ 



FUNC 40 TO SET SIZE OF HISTOGRAM 



REJCT LDA BN7 

JMP DONEX+1 



=140001 REQUEST ERROR 



SETSZ LDA $DV16, I 
CMA 

LDB $DV17,I DOUBLE WORD INTEGER 

CMB, INB, SZB, RSS 

INA 

DST #MEAS - HISTOGRAM CNT (2 WORD) 



DONEX CLA 

STA DVT16, I 



SET ERROR CODE 
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CLC 30B,C ENSURE PR DISABLED 

CLA 

JMP ID. 51, I PHYSICAL DONE EXIT 
SPC 3 

* TIME-OUT 
TMOUT LDA B3 

JMP DONEX+1 RETURN ERROR 3 
SPC 3 

* DATA AREA 
IFT7 NOP 
IFTX NOP 
DVT 16 NOP 
BUFAD NOP 
NEGAD NOP 
NRANG NOP 
#WD NOP 

* 

WMAP NOP 
EOSV NOP 
QSAV NOP 
ZSAV NOP 
GLOBL NOP 
MPFSV NOP 
INTMASK NOP 



#MEAS 


DEC 


0,0 


MEASX 
* 


DEC 


0,0 


Bl 


OCT 


1 


B2 


OCT 


2 


B3 


OCT 


3 


B7 


OCT 


7 


B4000 


OCT 


4000 


B7700 

* 


OCT 


7700 


N6 


DEC 


-6 


BN7 
* 


OCT 


140001 


ASV 


BSS 


2 


* 







END 
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I/O Card Programming 



This chapter briefly describes how the system performs I/O. For more detailed information, refer 
to the Operating & Reference Manual for the A-Series processor. 

Two kinds of I/O programming are possible: interrupt per word or byte and interrupt per block. 
The latter uses DMA (direct memory access). 

I/O instructions are executed by an I/O microprocessor chip common to every I/O card. The 
central processor and the I/O chip communicate along the backplane bus. When communication 
takes place, the I/O chip and the central processor operate as a single computer to process I/O 
transfers through an I/O channel. 

The two-digit octal select code represents the address of the I/O interface card on the backplane 
and is the basis for linking the main processor with a particular I/O card. Bits 5-0 of an I/O 
instruction may reference either the select code or a register on the I/O chip, depending on the 
state of the global register and the actual value in bits 5-0. 

Select codes 20B through 77B are available to I/O drivers. The choice of which select code to use 
(controlled by jumper on the interface) depends on the following: 

1. The privileged interrupt mask controls a group of four select codes with a single bit. 
Therefore, the generator will report an error if a normal and privileged driver are assigned to 
the same bit in the mask. 

2. Conventions established for use at the local site. 

Each interface card contains the I/O chip common to all I/O cards, and card logic unique to the 
function of the card. The I/O driver communicates with the card logic by accessing registers on the 
I/O chip. The chip manages the card logic to enable data transfers in the DMA mode or in the 
interrupt per byte or word mode. 

The select code field in an I/O instruction can specify the chip register. Each register has 
associated with it a control bit and a flag bit (these are 1-bit registers) to manage the direction of 
data flow. Generally, the control bit is set to indicate that the driver is ready, and the flag is set to 
indicate that the device is ready. Usually, the flag is cleared by the driver when the transfer is 
initiated: when the device finishes, the flag is set by the device (or the I/O chip) to generate an 
interrupt. The flag may also be set by the driver to abort or suspend a transfer. 

The registers are numbered 0 through 77 octal, but only the following registers are of interest to 
the I/O driver: 

1. Global Register: register 02. When the global register is enabled, its contents specify an 
interface card which is to process I/O instructions whose select code is in the range 20B-77B. 

2. Virtual Control Panel: register 24. This register is used to indicate the use of the card by the 
Virtual Control Panel code. 
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3. Card Registers: registers 30, 31, 32. The card registers control the card logic which is unique 
to the function of the card. 

4. DMA Registers: registers 20, 21, 22, 23. These registers are used to manage block transfers 
to and from memory. 

The I/O chip will always recognize select codes 02 and 03, regardless of the state of the global 
register. In addition, with the global register disabled, the chip will recognize instructions 
addressed to its own select code. 

The system's standard interface drivers (that is, non-privileged drivers) are always entered by the 
system with the global register set and enabled for the select code taken from the IFT Therefore, 
those drivers need not concern themselves with register 02. 

The card registers (30, 31, 32) are accessed in the same manner for each card. The contents and 
meaning of these registers is unique to the card function. 

Handling of the DMA registers is nearly the same for every card. The differences are for the 
convenience of the driver, rather than required by the card. 

The card registers and the DMA registers are described separately in the following sections. 



The Global Register 



The global register is 6 bits wide and is designed to contain a select code. The register is loaded 
and read by the instructions: 

OTA/B 2 Load Global Register from A/B 

LIA/B 2 Read Global Register into A/B 

LI A/B 2 , C Read and clear the flag 

MI A/B 2 Merge with A/B Register 

MI A/B 2 , C Merge and clear the flag 

The value loaded into the global register must be in the range 20B-74B; else the interface card will 
go into a diagnostic mode. 

The global register is enabled/disabled by: 
CLF 2 Enable Global Register 
STF 2 Disable Global Register 

and tested with: 

SFS 2 Skip if the flag set 
SFC 2 Skip if the flag clear 

All I/O chips recognize select code 2, regardless of the state of register 02. When register 02 is 
disabled, however, the I/O chip will recognize only register 02 and the register corresponding to its 
own select code. 

When the global register is enabled, the select code is used to indicate a register in the range 
20B-74B. However, not all of these registers have defined usage. 

Hewlett-Packard interface cards and RTE-A interface drivers are designed to be used only with 
the global register enabled. 
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Virtual Control Panel Register 



Register 24 is used by the Virtual Control Panel to indicate that it has used that I/O card. This 
register will be set equal to minus one (-1) prior to exit from the VCP program. This value 
signals the driver to restart any request which may have been aborted as a result of the VCP 
operation. 

The control and flag bits are set on the I/O cards used. Thus, upon return to the operating system, 
an interrupt will occur. If the select code is used by a driver in the system, then a continue entry 
will be made into the interface driver to service the interrupt. If no driver uses the select code, the 
interrupt is ignored by the system. 

Drivers which use register 24 include terminal drivers that can process the keyboard used by the 
VCP program and any boot devices which may be referenced by the VCP program. For example, 
since a boot may occur over the network interface, then the driver for the network interface card 
should use register 24. 

Below is an example of the procedure the driver should follow to use register 24: 

LIA 24B 

CONT SZA, RSS REMOTE CONTROL INTERRUPT? 

JMP CONT1 NO. CONTINUE PROCESSING 

CLA YES. 

OTA 24B CLEAR INDICATOR REGISTER 

* PERFORM ESSENTIALLY THE SAME PROCESS AS IF 

* A POWER-FAIL RESTART. EXAMPLE BELOW. 



LDB 


$IF6, I 


GET AVAILABILITY 


SSB, 


RSS 


BUSY? 


JMP 


BRK 


NO. RESET ANY ASYNCH INTERRUPTS EXPECTED 


LDA 


REDO 


RESTART REQUEST IN PROGRESS 


STA 


$DV16, I 


DON'T DOWN, DON'T FLUSH, NO ERR MESS 


CLC 


ZIB, C 




CLC 


23B, C 


TERM ANY DMA SO NO CONFLICT ON REENTRY 


JSB 


STAT 




CLA 




SYSTEM FLAGS = 0 


JMP 


ID .XX, I 


"DONE" EXIT. 


OCT 


100077 


"D" BIT + ERROR CODE 63 


EQU 







* NORMAL PROCESSING CONTINUE HERE 



Prior to exit, the driver should always clear register 24. To accomplish this: 

CLA 

OTA 24B 
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Card Registers 



The interface card registers, 30, 31, and 32, are accessed only with the global register enabled. 
The instruction set is given below with XX representing the register number 30 to 32. 



LIA/B XX 


Move card register to A/B register 


LIA/B XX, C 


Move and clear the flag 


MIA/B XX 


Merge card register into A/B register 


MIA/B XX, C 


Merge and clear the flag 


SFS XX 


Skip if the flag set 


SFC XX 


Skip if the flag clear 


STC XX 


Set device control 


STC XX, C 


Set control and clear flag 


STF XX 


Set the flag 


CLF XX 


Clear the flag 



Register 30 stores data. An OTA sends data to the card; an LIA removes a data word from the 
card. 

Register 31 is for card control. An OTA sends a word to the card which "configures" it. 
Configuration affects the way the card handles data and is analogous to setting jumpers on the 
interface card. 

An LIA 32 instruction reads the card status, which may include device status as well, depending on 
the card. 

Register 32 is not used on all I/O cards. Where used, it is specific to the card. The following 
examples illustrate how to use the card registers. 

USING THE CARD REGISTERS FOR INPUT 

The operations below assume that the global register is set up and enabled. 

LDA CNTRL Get control word 

OTA 31B Output to card 

STC 30B,C Start device 



The FLAG on the data register (30) is set when the device is ready with data. In addition, FLAG 
30 is the flag for the entire interface card and may, therefore, generate interrupts, if they are 
enabled. FLAG 30 may also be tested under program control as follows: 

SFS 30B Wait for data flag ready 

JMP *-l 

LIA 30B Now get data 

The FLAG remains set until reset under program control, which is normally done when a new 
operation is started. To initiate another input: 

STC 30B,C 

When the final value has been read, the interface should be set to a known state by: 

CLC 30B,C 

which clears the card control and flag. 
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USING THE CARD REGISTERS FOR OUTPUT 

The operations below assume that the global register has been set up and enabled. 



LDA 


CNTRL 


Get control word 


OTA 


31B 


Output to card 


LDA 


DATA, I 


Get first data word 


OTA 


30B 


Send to card 


STC 


30B, C 


Start the card going 



When the data transfer is complete, FLAG 30 will be set and may generate an interrupt or be 
tested in the same manner as discussed under INPUT To start the next transfer: 

ISZ DATA Increment the data pointer 

LDA DATA, I Get next data word 

OTA 30B Send to the card 

STC 30B,C Restart the device 



Again, at completion the card should be reset as follows: 

CLC 30B,C Clear card control and flag bits 



DMA Registers 

Incorporated into every I/O chip is the ability to transfer data directly to or from memory. All 
necessary control logic and registers are contained in the I/O chip to supervise the memory 
transaction. The I/O chip and logic circuits on the interface card interact to manage the flow of 
data and control signals. 

There are four DMA control registers on the I/O chip: 



Reg# Purpose 

20 DMA Self-Configuration Register 

21 DMA Control Register 

22 Address Register 

23 Data Count Register 



The self-configuration feature permits DMA transfers to be chained together. The individual 
transfers are described by triplets (or quadruplets) in processor memory. When using the DMA 
chaining feature, only the address of the first chain needs to be given to the I/O chip. When one 
transfer completes, the next is initiated automatically with very little overhead. 
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DMA Initiation 



The I/O sequence required to initiate a non-chained DMA transfer is as follows: 

LDB $DV1 SET THE PORT MAP 

JSB $ SETR 

IOR CNTL GET DMA CONTROL WORD 

OTA 21B OUTPUT TO CONTROL REGISTER 

LDA ADDR GET ADDRESS OF MEMORY BLOCK 

OTA 22B OUTPUT TO DMA ADDRESS REGISTER 

LDA CNT GET DATA COUNT 

OTA 2 3B OUTPUT TO DATA COUNT REGISTER 

STC 21B,C START DMA AND CLEAR INTERRUPT FLAG 



CNTL BSS 1 SET UP BY PROGRAM TO DESCRIBE TRANSFER 

ADDR DEF BUFR POINTS TO STORAGE 

CNT BSS 1 DATA COUNT STORED HERE AS NEGATIVE VALUE 

The data count is initialized to the negative of the word count or the byte count, according to bit 13 
in the control word. 

The sequence needed to initialize a chained transfer is even simpler: 

LDA PNTR GET ADDRESS OF CHAIN 

OTA 20B TELL IT TO I/O CHIP 

STC 20B,C CLEAR INTERRUPT FLAG AND START CHAIN 

A sample chain is given below. The example also illustrates the bits in the DMA control word. 

CONT EQU 100000B CONTINUE SELF-CONFIGURATION CHAIN 

DEVCM EQU 040000B ISSUE DEV COM PULSE AFTER EA WD/BYTE 

BYTE EQU 020000B DATA COUNT IS IN BYTES 

RES EQU 010000B OVERWRITE DATA COUNT WITH RESIDUE AT END 

CINT EQU 004000B INHIBIT DMA INTERRUPT FLAG 

REM EQU 0 02 0 0 OB USE REMOTE MEMORY 

FOUR EQU 001000B THIS LINK IS A QUADRUPLET 

AUTO EQU 000400B DON'T WAIT FOR SRQ FROM DEVICE 

IN EQU 0 0020 OB TRANSFER IS TO MEMORY FROM DEVICE 

RELOC .... MUST BE OR' ED INTO CONTROL WORD BEFORE 

* STARTING THE TRANSFER 

PNTR DEF BUFR 

BUFR ABS CONT+AUTO+RELOC DMA CONTROL: OUTPUT TRIPLET 

DEF DATA ADDRESS OF MEMORY BLOCK 

CNT1 DEC -10 NEG OF WORD COUNT IN DATA 

ABS CONT+AUTO+IN+RELOC DMA CONTROL: INPUT TRIPLET 
DEF INPT ADDRESS OF INPUT BUFFER 

CNT2 DEC -10 NEG # WORDS IN INPUT BUFFER 

ABS BYTE+AUTO+FOUR+RELOC DMA CONTROL: LAST LINK IS QUADRUP . 



DEF CTRL THIS IS A CONTROL WORD FOR I/O CARD 

DEF DONE ADDRESS OF LAST BLOCK 
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DEF 



CNT3 



BYTE COUNT OF BLOCK AT DONE BUFFER 



DATA 
INPT 
DONE 



BSS 
BSS 
BSS 



10 
15 
5 



OUTPUT DATA BUFFER 
INPUT DATA BUFFER 
FINAL BUFFER IN CHAIN 



The chain is "self-configuring" because the I/O chip takes over loading its registers 21, 22 and 23 
from the consecutive memory locations beginning at the pointer which is put in register 20. As 
each memory location is accessed, the value of register 20 is incremented by the I/O chip. The 
new value in register 20 is used as the address of the next memory read. 

If the "FOUR" bit is set in the DMA control word, then the second word in the link is loaded into 
chip register 31, the card control word. Subsequent words are loaded into registers 21, 22, and 23 
— the same as for the triplet. 

The self-configuration timing is variable, according to whether the DMA interrupt flag is on or off, 
and whether this is an initial configuration (top of chain) or a reconfiguration (subsequent link in 
chain). The hardware manual should be consulted for actual times. However, the 
self-configuration will always execute faster than the equivalent loading of registers 21, 22 and 23 
by the driver itself. 



DMA Termination 

A DMA transfer can terminate from several causes: 

1. The data count goes from -1 to 0. This means that the I/O chip has completed the number of 
I/O cycles specified in register 23. It does not mean all cycles resulted in a successful memory 
access. For example, if several high-speed synchronous devices are competing for memory, a 
lower priority interface may experience a DMA overrun. 

2. End-of-transmission. This is determined by the individual interface card, which may 
recognize a record terminator. For example, an input from a terminal may complete with a 
carriage return — regardless of data count specified in register 23. The transfer will never 
exceed the DMA count. 

3. Memory parity error during DMA input transfer. 

In addition, the I/O driver can programmatically suspend or abort a DMA operation. This may be 
desirable when the driver is called upon to perform the abort function. This feature will be 
described further in the section on DMA Flags. 

The "residue" (DMA count at completion) may be read from the chip register 23 (LIA/B 23). In 
addition, if the RES bit is set in the DMA control word, the residue will be written into the same 
word from which data count was taken (chained operation only). Assuming no parity error or 
device error, the residue can be used to determine the actual number of words/bytes transferred 
on output or input. 



I/O Card Programming 9-7 



DMA Control and Flag Bits 



The I/O instructions that permit the driver to manage the control and flag bits for each of registers 
20 through 23 follow, with descriptions of their functions. 



Reg Instr Meaning 

20 STC Enable DMA self-configuration logic 
CLC Suspend self-configuration logic 
STF Set self-configuration flag 

CLF Clear self-configuration flag 

SFS Test flag 

21 STC Enable non-chained transfer 
CLC Suspend current DMA operation 
STF Set DMA flag 

CLF Clear DMA flag 

SFS Test if DMA flag set (operation complete) 

22 STC Not implemented; NOP 

CLC Abort current DMA operation, proceed to next 

self-configured operation 

STF Set DMA parity error flag 

CLF Clear DMA parity error flag 

SFS Test if DMA parity error 

23 STC Not implemented; NOP 

CLC Abort self-configuration and any transfer in progress 

STF Set all three flags: 20, 21 and 22 

CLF Clear all three flags: 20, 21 and 22 

SFS Test if any of three flags set (20, 21 and 22) 



When an operation is suspended, it "pauses," and may be restarted with the appropriate STC 
instruction. If the device is synchronous, however, the effect of the pause may be lost data. This is 
commonly called a "DMA overrun," which means that the computer did not process the transfer 
before the next piece of information was presented. DMA overruns may also occur if several 
DMA transfers are in progress and high-priority select codes hold off transfers from low priority 
synchronous devices. 

At the end of a DMA transfer, up to 5 flags may be set as follows: 



Flag 20: Set upon completion of the last link in a chained transfer. Flag 20 is set if the 

residue has gone to zero. The occurrence of flag 20 will also set flag 21. 

Flag 21: Set upon completion of a block transfer except when using self-configuration. 

Like flag 20, it means that the residue has gone to zero. If self-configuration 
is in effect, the flag 21 is set by the occurrence of flag 20. 

Flag 22: Set if a memory parity error occurred on DMA output from memory. Unlike 

flags 20 and 21, flag 22 is not inhibited by the CINT bit in the DMA control 

Flag 23: This is an inclusive OR of flags 20, 21 and 22. 

Flag 30: Set at completion of DMA transfer only if this is a feature of the card. Some 

cards use this flag only for non-DMA transfers. 
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Index 



Symbols 

$CLWRT, 7-10 
$DIOC, 7-1 
$DMPR, 7-3 
$DVLU, 7-2 
$MSALC, 7-9 
SMSRTN, 7-9 
$ONER, 7-6 
$ONEW, 7-7 
$READ, 7-5 
$SELR, 7-8 
$SETM, 7-5 
$SETR, 7-7 
$UpIft, 7-2 
$UPIO, 7-2 
$WRIT, 7-6 
$XQSB, 7-3 

A 

abort, 4-4 
abort bit, 3-4 

allocate additional map sets, $MSALC, 7-9 
asynchronous interrupt, 3-2 
defined, 1-5 

response to attention, 6-3 

B 

buffer limit, 2-7 
See also S bit 



C 

card registers, 9-2 

circular DVT list, 2-5 

circular node list, 2-12 

class I/O from a driver, $CLWRL 7-10 

CLWRT, 7-10 

compute LU from DVT, $DVLU, 7-2 
control requests, 2-9 
control word, 5-1 

D 

deallocate a map set, $MSRTN, 7-9 
device 

availability, 2-5 

priority, 2-4, 2-12, 2-13 

status, 2-5, 2-6 

type, 2-6 

up, 7-2 



device driver 

entry and exit, 3-1 

exit flags, 3-2 

purpose, 1-3 
device table, 1-1, 2-1, 2-3 

extension, 2-5 

format of, 2-4 
DIOC, 7-1 

direct memory access. See DMA 
DMA 

chaining, 6-1, 9-7 

control and flag bits, 9-8 

initialization, 9-6 

overrun, 9-7, 9-8 

parity error, $DMPR, 7-3 

registers, 9-5 

residue, 9-7 

self-configuration, 9-5, 9-7 

termination, 9-7 
DMPR, 7-3 
double buffering, 2-11 

See also Z bit 
down device, 5-6 
driver 

entry points, 1-9 

interaction with user request, 1-5 

NAM record, 1-7 

parameter area, 2-12 

parameters, 1-10, 3-3, 5-1 

requests, 1-2 

type codes, 1-8 
DVLU, 7-2 
DVT See device table 
dynamic status. See status requests 



E 

end-of-record, 5-2 
end-of-transmission, 9-7 
error 

bit, 2-11, 5-5 

codes, table of, 5-7 

handling, 3-5, 4-5, 5-4, 5-6, 6-1 

messages, avoidance of, 5-7 

number, 5-6 

soft error, 2-6, 5-5 



F 

FIFO linking, 2-4 
flush, 5-6 
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G 

GEN instruction, 1-10 

generation defaults. See GEN instruction 

global register, 9-1, 9-2, 9-5 

I 

I bit, 2-12 

I/O under program control, 9-4 
IFT. See interface table 
illegal requests, 5-4 
initial entry, 2-14 
interface 

card, characters, 2-14 

driver, purpose, 1-3 

lock, 3-6 

type, 2-14 
interface table, 2-13 

extension, 2-15 

format of, 2-13 
interrupt table, 2-1 

format of, 2-15 

L 

Lbit, 2-11, 6-2, 7-5 
lock. See interface lock 
logical unit table, 1-1, 2-1 

format of, 2-3 
LUT. See logical unit table 

M 

map registers set up, 7-5 
map set table, 2-1 
format of, 2-15 
mapping considerations, 7-4 
memory protect, 1-1 
MSALC, 7-9 
MSRTN, 7-9 

multibuffered request, 6-1 
format of, 6-1 

N 

N bit, 2-5 

names. See driver NAM record 
node busy bit, 2-5 

O 

one word read 

$ONER, 7-6 

SREAD, 7-5 
one word write 

$ONEW, 7-7 

SWRIT, 7-6 
ONER, 7-6 
ONEW, 7-7 



P 

P bit, 2-5 
parameter 

checking, 3-3 

passing, 6-1 
parity error, 7-3, 9-7 
pointer set-up, 6-2, 7-1 
polling, 6-3 
port map 

selection, 7-8 

set up, 7-7 
power fail, 3-5, 4-4 
privileged driver 

entry points, 8-1 

processing, 8-1 

system entry points, 8-1 

trap cells, 8-1 
privileged interrupt mask, 9-1 
program scheduling, $XQSB, 7-3 
pseudo done, 4-6, 6-3 

Q 

Q bit, 2-4, 2-13 
R 

READ, 7-5 

read data word/map selected, $READ, 7-5 
read one word without setup, $ONER, 7-6 
request 

advance inhibit, 4-6 

code subfunction, 2-8 

control block, 1-1 

delay, 3-6, 4-6 

flush, 5-6 

initiation list, 2-4 

interaction, 1-4 

length, 2-11 

linking, 1-1 

parameters, 2-11 

types, 5-1 
restart, 5-7 
routines 

$CLWRT, 7-10 

$DIOC, 7-1 

$DMPR, 7-3 

$DVLU, 7-2 

$MSALC, 7-9 

SMSRTN, 7-9 

$ONER, 7-6 

$ONEW, 7-7 

$READ, 7-5 

$SELR, 7-8 

$SETM, 7-5 

$SETR, 7-7 

SUpIft, 7-2 

$UPIO, 7-2 

SWRIT, 7-6 

SXQSB, 7-3 
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s 

S bit, 2-8 

scheduling programs, 7-3 
select code, 2-14, 9-1, 9-2 
in I/O instruction, 9-1 
select port map number, SSELR, 7-8 
SELR, 7-8 

set port map, $SETR, 7-7 

set up DVT or IFT, $DIOC, 7-1 

set up map registers, $SETM, 7-5 

SETM, 7-5 

SETR, 7-7 

status, 1-2, 3-5, 5-4 

extended, 6-1 

of interface card, 9-4 
status byte, format of, 5-5 
system flags, 2-14, 3-5, 3-6, 4-5 



T 

table 

pointers, 2-16 

reference by driver, 6-2 
terminal, driver, 6-3 
time base generator (TBG), 1-5 
timeout, 2-13, 4-4, 4-6 

of device, 3-4 



transmission log, 5-4, 6-1 
definition, 5-4 

U 

up all LUs referring to this IFT, Uplft, 7-2 
up device, $UPIO, 7-2 
Uplft, 7-2 
UPIO, 7-2 
user request, 6-1 

V 

virtual control panel, 9-3 
impact upon drivers, 9-3 

W 

WRIT, 7-6 

write data word/map selected, $WRIT, 7-6 
write one word without setup, $ONEW, 7-7 

X 

XQSB, 7-3 
Z 

Zbit, 2-11, 5-2, 6-2 
zero length records, 5-3 
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